Get Profile and Workspaces

Retrieve your profile and workspace details using your API key or OAuth token


Retrieve your user profile and associated workspaces. Works with both API keys and OAuth access tokens.

  • API Key: Returns the single workspace linked to the key
  • OAuth Token: Returns all workspaces the token has been granted access to

Endpoint#

https://api.orshot.com/v1/me

Request#

await fetch("https://api.orshot.com/v1/me", {
  method: "GET",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

Response Fields#

FieldTypeDescription
user_idStringYour unique user ID
emailStringYour email address
nameStringYour full name
workspacesArrayList of workspaces accessible with this token
workspaces[].idNumberWorkspace ID
workspaces[].nameStringWorkspace name
workspaces[].slugStringWorkspace slug

Error Responses#

Unauthorized (401)#

Returned when using an expired or invalid OAuth token.

{
  "error": "Access Forbidden",
  "message": "OAuth token expired or invalid"
}

Forbidden (403)#

Returned when the API key is missing or invalid.

{
  "error": "Access Forbidden"
}

Rate Limits#

  • 20 requests per minute per API key

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key
  • Image, PDF and video generation via API
  • Visual editor with AI and smart layouts
  • Zapier, Make, MCP and 50+ integrations
  • White-label embed for your own app
  • 60 free renders — no credit card required