EUrouter

Organizations

Manage EUrouter organizations, their profiles and credit balances through the API with an organization-wide management key.

OpenAPI JSON

List organizations

GET
/api/v1/organizations

List team organizations the authenticated user belongs to. A management key lists only its own organization; personal organizations are not included.

Authentication: Requires an organization-wide management key. Read-only management keys are accepted.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Response Body

application/json

curl -X GET "https://api.eurouter.ai/api/v1/organizations"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "slug": "string",
      "description": "string",
      "url": "string",
      "logo_url": "string",
      "address_line1": "string",
      "address_line2": "string",
      "address_city": "string",
      "address_region": "string",
      "address_postal_code": "string",
      "address_country": "string",
      "legal_name": "string",
      "vat_number": "string",
      "tax_id": "string",
      "registration_number": "string",
      "billing_email": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ]
}

Create organization

POST
/api/v1/organizations

Create an organization. The creator becomes its owner.

Authentication: Requires an organization-wide management key. Read-only management keys cannot use this endpoint.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://api.eurouter.ai/api/v1/organizations" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "slug": "string",
    "description": "string",
    "url": "string",
    "logo_url": "string",
    "address_line1": "string",
    "address_line2": "string",
    "address_city": "string",
    "address_region": "string",
    "address_postal_code": "string",
    "address_country": "string",
    "legal_name": "string",
    "vat_number": "string",
    "tax_id": "string",
    "registration_number": "string",
    "billing_email": "string",
    "created_at": "string",
    "updated_at": "string"
  }
}

Get organization

GET
/api/v1/organizations/{orgId}

Get details for an organization.

Authentication: Requires an organization-wide management key. Read-only management keys are accepted.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

curl -X GET "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "slug": "string",
    "description": "string",
    "url": "string",
    "logo_url": "string",
    "address_line1": "string",
    "address_line2": "string",
    "address_city": "string",
    "address_region": "string",
    "address_postal_code": "string",
    "address_country": "string",
    "legal_name": "string",
    "vat_number": "string",
    "tax_id": "string",
    "registration_number": "string",
    "billing_email": "string",
    "created_at": "string",
    "updated_at": "string"
  }
}

Update organization

PATCH
/api/v1/organizations/{orgId}

Update an organization's details. The slug is a stable identifier and is not changed on rename.

Available only for team organizations. Personal organizations receive 403.

Authentication: Requires an organization-wide management key. Read-only management keys cannot use this endpoint.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PATCH "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "slug": "string",
    "description": "string",
    "url": "string",
    "logo_url": "string",
    "address_line1": "string",
    "address_line2": "string",
    "address_city": "string",
    "address_region": "string",
    "address_postal_code": "string",
    "address_country": "string",
    "legal_name": "string",
    "vat_number": "string",
    "tax_id": "string",
    "registration_number": "string",
    "billing_email": "string",
    "created_at": "string",
    "updated_at": "string"
  }
}

Get organization profile

GET
/api/v1/organizations/{orgId}/profile

Get EUrouter-specific profile and billing identity fields for an organization.

Available only for team organizations. Personal organizations receive 403.

Authentication: Requires an organization-wide management key. Read-only management keys are accepted.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

curl -X GET "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/profile"
{
  "data": {
    "description": "string",
    "url": "string",
    "address_line1": "string",
    "address_line2": "string",
    "address_city": "string",
    "address_region": "string",
    "address_postal_code": "string",
    "address_country": "string",
    "legal_name": "string",
    "vat_number": "string",
    "billing_email": "string"
  }
}

Update organization profile

PATCH
/api/v1/organizations/{orgId}/profile

Update EUrouter-specific profile and billing identity fields. Better Auth identity fields are not accepted here.

Available only for team organizations. Personal organizations receive 403.

Authentication: Requires an organization-wide management key. Read-only management keys cannot use this endpoint.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PATCH "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/profile" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "description": "string",
    "url": "string",
    "address_line1": "string",
    "address_line2": "string",
    "address_city": "string",
    "address_region": "string",
    "address_postal_code": "string",
    "address_country": "string",
    "legal_name": "string",
    "vat_number": "string",
    "billing_email": "string"
  }
}

Get organization credits

GET
/api/v1/organizations/{orgId}/credits

Get the organization's shared wallet balance and lifetime credit totals.

Authentication: Requires an organization-wide management key. Read-only management keys are accepted.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

curl -X GET "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/credits"
{
  "data": {
    "balance": "string",
    "total_credits": "string",
    "total_usage": "string"
  }
}

Ensure default organization workspace

PUT
/api/v1/organizations/{orgId}/workspaces/default

Return the organization's default workspace, creating it once when it does not exist.

Available only for team organizations. Personal organizations receive 403.

Authentication: Requires an organization-wide management key. Read-only management keys cannot use this endpoint.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

curl -X PUT "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/workspaces/default"
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "slug": "string",
    "description": "string",
    "created_at": "string",
    "created_by": "string",
    "updated_at": "string",
    "default_text_model": "string",
    "default_image_model": "string",
    "default_provider_sort": "string",
    "is_observability_io_logging_enabled": true,
    "is_observability_broadcast_enabled": true,
    "is_data_discount_logging_enabled": true,
    "io_logging_sampling_rate": 0,
    "io_logging_api_key_ids": [
      "string"
    ]
  }
}

List organization invitations

GET
/api/v1/organizations/{orgId}/invitations

List invitations for an organization.

Authentication: Requires an organization-wide management key. Read-only management keys are accepted.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

curl -X GET "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/invitations"
{
  "data": [
    {
      "id": "string",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "email": "user@example.com",
      "role": "string",
      "status": "string",
      "inviter_id": "string",
      "expires_at": "string",
      "created_at": "string"
    }
  ]
}

Create organization invitation

POST
/api/v1/organizations/{orgId}/invitations

Invite a user to join an organization as an admin or member.

Authentication: Requires an organization-wide management key. Read-only management keys cannot use this endpoint.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/invitations" \  -H "Content-Type: application/json" \  -d '{    "email": "user@example.com",    "role": "admin"  }'
{
  "data": {
    "id": "string",
    "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
    "email": "user@example.com",
    "role": "string",
    "status": "string",
    "inviter_id": "string",
    "expires_at": "string",
    "created_at": "string"
  }
}

List organization members

GET
/api/v1/organizations/{orgId}/members

List members in an organization.

Authentication: Requires an organization-wide management key. Read-only management keys are accepted.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

curl -X GET "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/members"
{
  "data": [
    {
      "user_id": "string",
      "email": "user@example.com",
      "name": "string",
      "role": "string",
      "joined_at": "string"
    }
  ]
}

Update organization member role

PATCH
/api/v1/organizations/{orgId}/members/{userId}

Change an organization member's role. Owners are managed separately and cannot be set or changed here.

Authentication: Requires an organization-wide management key. Read-only management keys cannot use this endpoint.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
userId*string

User ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PATCH "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/members/string" \  -H "Content-Type: application/json" \  -d '{    "role": "admin"  }'
{
  "data": {
    "user_id": "string",
    "email": "user@example.com",
    "name": "string",
    "role": "string",
    "joined_at": "string"
  }
}

Remove organization member

DELETE
/api/v1/organizations/{orgId}/members/{userId}

Remove a member from an organization.

Authentication: Requires an organization-wide management key. Read-only management keys cannot use this endpoint.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
userId*string

User ID

Response Body

application/json

curl -X DELETE "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/members/string"
{
  "data": {
    "success": true
  }
}

Revoke organization invitation

POST
/api/v1/organizations/{orgId}/invitations/{invitationId}/revoke

Revoke an organization invitation so it can no longer be accepted.

Authentication: Requires an organization-wide management key. Read-only management keys cannot use this endpoint.

Authorization

organizationManagementKey
AuthorizationBearer <token>

Requires organization-wide access. Management key from Settings → Management keys. Format: eur_mgmt_<public-id>.<secret>. Read-only management keys support GET and HEAD only.

In: header

Path Parameters

orgId*string

Organization ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
invitationId*string

Invitation ID

Length1 <= length

Response Body

application/json

curl -X POST "https://api.eurouter.ai/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/invitations/string/revoke"
{
  "data": {
    "id": "string",
    "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
    "email": "user@example.com",
    "role": "string",
    "status": "string",
    "inviter_id": "string",
    "expires_at": "string",
    "created_at": "string"
  }
}

Was this page helpful?

Still stuck? Contact support