Project Service¶

Project management and analytics API operations.

Projects live within organizations. The project service exposes endpoints for CRUD operations, analytics via the Langfuse-compatible metrics API, API key management, member management, and more. Base URL is set via REACT_APP_ORGANIZATIONS_API_BASE_URL.

All requests require Api-Key and Authorization: Bearer <token> headers.

List Projects¶

http theme={null} GET https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects

List projects within an organization with optional filtering and sorting.

The organization’s unique ID.

Filter by the authenticated user’s role(s). Accepts comma-separated values: OWNER, ADMIN, MEMBER, VIEWER.

Filter to projects that have a wallet.

Filter to projects that have tools.

Filter to projects that have notebooks.

Minimum member count.

Maximum member count.

Filter by name substring (case-insensitive).

Sort field. One of: name, created_at, updated_at, alphabetical, members_count, tools_count, notebooks_count, recent_activity.

ISO 8601 timestamp. Return only projects created after this date.

ISO 8601 timestamp. Return only projects created before this date.

```bash theme={null} curl "https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/123/projects?sort=name&user_role=OWNER,ADMIN" \ -H "Authorization: Bearer " \ -H "Api-Key: "

**Response:** `{ "data": [ ...project objects ] }`

List results are cached for 5 minutes. Pass `forceRefresh=true` to bypass the cache.

***

## Create Project

<CodeGroup>
  ```http  theme={null}
  POST https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects
  ```
</CodeGroup>

Create a new project within an organization.

<ParamField path="organizationId" type="string" required>
  The organization’s unique ID.
</ParamField>

<ParamField body="data.attributes.name" type="string" required>
  The name for the new project.
</ParamField>

```bash  theme={null}
curl -X POST https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/123/projects \
  -H "Authorization: Bearer <token>" \
  -H "Api-Key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "attributes": { "name": "My New Project" }
    }
  }'

Get Project¶

http theme={null} GET https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}

Fetch details for a specific project, including related users, API keys, LLM API keys, and Sentinel Passes.

The organization’s unique ID.

The project’s unique ID.

When true, includes encrypted secret keys in the response under meta.secrets.

Comma-separated related resources. Supported: users, apiKeys, llmApiKeys, sentinelPasses.

bash theme={null} curl "https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/123/projects/456?secret=true&include=users,apiKeys" \ -H "Authorization: Bearer <token>" \ -H "Api-Key: <your_api_key>"

The project ID.

The project name.

Whether this is the organization’s default project.

The project’s public API key (only present when secret=true).

The project’s secret API key (only present when secret=true).

Related resources when include is specified. API key objects contain type: "apiKey", attributes.publicKey, and attributes.encryptedSecretKey.

Update Project Name¶

http theme={null} PATCH https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}

The organization’s unique ID.

The project’s unique ID.

Must match projectId.

Must be "project".

The new name for the project.

Delete Project¶

http theme={null} DELETE https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}

Permanently delete a project. This also removes the project’s API keys from local storage.

The organization’s unique ID.

The project’s unique ID.

API Key Management¶

Create API Key¶

http theme={null} POST https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/api_keys

The organization’s unique ID.

The project’s unique ID.

A human-readable label for the API key.

Optional ISO 8601 expiration datetime.

Update API Key¶

http theme={null} PATCH https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/api_keys/{apiKeyId}

The new label for the API key.

Delete API Key¶

http theme={null} DELETE https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/api_keys/{apiKeyId}

LLM API Key Management¶

Create LLM API Key¶

http theme={null} POST https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/llm_api_keys

Must be "llm_api_keys".

The LLM provider (e.g., "openai", "anthropic").

The API key from the LLM provider.

Optional list of custom model identifiers to associate with this key.

Whether to include the provider’s default models. Defaults to true.

Delete LLM API Key¶

http theme={null} DELETE https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/llm_api_keys/{apiKeyId}

Member Management¶

List Project Users¶

http theme={null} GET https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/users

Add User to Project¶

http theme={null} POST https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/add_user

Add an existing user to a project. Automatically falls back to sending a project invitation if the user is not found.

Must be "users".

The email address of the user to add.

The project role. One of: OWNER, ADMIN, MEMBER, VIEWER.

The organization role to assign. Must be equal to or higher than the project role. Required when project_only is false.

When true, adds the user to the project without affecting their organization membership.

Update Member Role¶

http theme={null} PATCH https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/members/{userId}/role

The new role. One of: OWNER, ADMIN, MEMBER, VIEWER.

Remove Member from Project¶

http theme={null} DELETE https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/remove_user/{userId}

Deny Project Access¶

http theme={null} POST https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/deny_access/{userId}

Revoke a user’s access to a project without removing them from the organization.

Restore Project Access¶

http theme={null} POST https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/restore_access/{userId}

Optional. The role to restore. Uses the user’s previous role if omitted.

Project Invitations¶

Send Project Invitation¶

http theme={null} POST https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/invitations

Must be "membershipInvitation".

The email address to invite.

The project role on acceptance. Defaults to "member".

The organization role on acceptance.

When true, the invitation grants project access only.

List Project Invitations¶

http theme={null} GET https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/invitations

Resend Project Invitation¶

http theme={null} POST https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/invitations/{invitationId}/resend

Cancel Project Invitation¶

http theme={null} DELETE https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/organizations/{organizationId}/projects/{projectId}/invitations/{invitationId}

Analytics¶

Project analytics use project-specific public/secret key pairs (retrieved from the project details endpoint with secret=true) and are served by the analytics microservice at REACT_APP_LANGFUSE_API_URL.

Get Daily Metrics¶

http theme={null} GET https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/api/public/metrics/daily

Authenticate with HTTP Basic Auth using the project’s publicKey as the username and secretKey as the password.

ISO 8601 start timestamp.

ISO 8601 end timestamp.

Optional comma-separated tags to filter metrics.

Array of daily metric data points.

List Traces¶

http theme={null} GET https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/api/public/traces

Authenticate with HTTP Basic Auth.

Page number (1-indexed).

Items per page.

Filter by trace name.

Filter by user ID.

Filter by session ID.

ISO 8601 start timestamp.

ISO 8601 end timestamp.

Sort field.

Filter by tags.

Array of trace objects.

Pagination metadata.

Get Trace by ID¶

http theme={null} GET https://api.traylinx.com/ma-metrics-wsp-ms/v1/api/api/public/traces/{traceId}

Authenticate with HTTP Basic Auth. Returns the full trace detail object.

Built with Mintlify.