> ## Documentation Index
> Fetch the complete documentation index at: https://developers.phrase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication and access

Exchange a Phrase Platform API token for a JSON Web Token (JWT) at the Platform OAuth token endpoint, as described in [Platform Authentication](https://developers.phrase.com/en/api/platform/authentication.md).

```bash theme={null}
curl -X POST https://eu.phrase.com/idm/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=urn:ietf:params:oauth:grant-type:token-exchange" \
  -d "subject_token=$PHRASE_API_TOKEN"
```

Send the JWT from `access_token` in the `Authorization` header of every request. It expires after `expires_in` seconds; request a new one then.

```bash theme={null}
curl "https://eu.phrase.com/orchestrator/api/v1/workflows?page_size=1" \
  -H "Authorization: Bearer $PHRASE_JWT"
```

A missing, expired or invalid token, or one not issued for Orchestrator, returns `401`. A valid token returns `403` when the user may not perform the action on the resource.

## Access

A workflow is available to its owner and to everyone it's shared with, directly or through their organization. They can all read and change it, including its revisions, tasks, dependencies, trigger and executions, but only the owner can delete it. Folders and variables are private to the user who created them. Actions, events and templates are a catalog every user can read, though some actions are only available to the users or organizations they were granted to. A resource you can't reach returns `404`, the same as one that doesn't exist.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.