Organizations
Manage EUrouter organizations, their profiles and credit balances through the API with an organization-wide management key.
List 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 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
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 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 details for an organization.
Authentication: Requires an organization-wide management key. Read-only management keys are accepted.
Authorization
organizationManagementKey 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
Organization ID
^([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)$uuidResponse 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
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 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
Organization ID
^([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)$uuidRequest 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 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 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
Organization ID
^([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)$uuidResponse 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
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 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
Organization ID
^([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)$uuidRequest 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 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 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
Organization ID
^([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)$uuidResponse 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
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 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
Organization ID
^([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)$uuidResponse 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
List invitations for an organization.
Authentication: Requires an organization-wide management key. Read-only management keys are accepted.
Authorization
organizationManagementKey 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
Organization ID
^([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)$uuidResponse 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
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 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
Organization ID
^([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)$uuidRequest 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
List members in an organization.
Authentication: Requires an organization-wide management key. Read-only management keys are accepted.
Authorization
organizationManagementKey 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
Organization ID
^([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)$uuidResponse 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
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 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
Organization ID
^([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)$uuidUser 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
Remove a member from an organization.
Authentication: Requires an organization-wide management key. Read-only management keys cannot use this endpoint.
Authorization
organizationManagementKey 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
Organization ID
^([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)$uuidUser 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
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 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
Organization ID
^([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)$uuidInvitation ID
1 <= lengthResponse 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"
}
}