Profiles API

You can use the Profiles API to programmatically run your Profiles project and check its run status.

Prerequisites

• Set up a Profiles project in the RudderStack dashboard.
• Generate a service access token in the RudderStack dashboard.

For production use cases, RudderStack recommends using a service access token instead of personal access token.

Authentication

The Profiles API uses Bearer authentication in the following format:

Authorization: Bearer <SERVICE_ACCESS_TOKEN>

Base URL

Use the base URL for your API requests depending on your region:

https://api.rudderstack.com/v2

https://api.eu.rudderstack.com/v2

Run project

You can trigger the run of a Profiles project using the below endpoint:

• Your Service Access Token must have the required permissions for authenticating the API to run this endpoint.
• To obtain the Profiles project ID, go to your project in the RudderStack dashboard and note it down from the URL:

Path parameters

Request body

Example request

POST /v2/sources/<profilesID>/start HTTP/1.1
Host: api.rudderstack.com
Content-Type: application/json
Accept: application/json
Authorization: Bearer <token>

{
  "parameters": ["--model_refs models/id_graph_users"]
}

curl --location 'https://api.rudderstack.com/v2/sources/<profilesID>/start' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
  "parameters": ["--model_refs models/id_graph_users"]
}'

Example response

{
  "runId": "<run_id>"
}

Response codes

Get run status

You can get the run status of your Profiles project using the below endpoint:

Path parameters

You can obtain the runId as the response of the above API endpoint (/sources/<profilesID>/start).

Example request

GET /v2/sources/<profilesID>/runs/{run_id}/status HTTP/1.1
Host: api.rudderstack.com
Accept: application/json
Authorization: Bearer <token>

curl --location 'https://api.rudderstack.com/v2/sources/<profilesID>/runs/<run_id>/status' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Example response

{
  "jobId": "string",
  "jobRunId": "string",
  "status": "string",
  "startedAt": "2024-05-31T06:48:08.228Z",
  "finishedAt": "2024-05-31T06:48:08.228Z",
  "tasks": [{
    "taskId": "string",
    "taskRunId": "string",
    "startedAt": "2024-05-31T06:48:08.228Z",
    "finishedAt": "2024-05-31T06:48:08.228Z"
  }]
}

Response codes

Questions? Contact us by email or on Slack