The Organization API from Recal — 3 operation(s) for organization.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/recal:recal-organization-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Recal Organization API
description: 'The official Recal.dev API.
**Tip:** Use `x-timezone` header to set timezone for all returned datetimes.'
version: 0.2.0
servers:
- url: https://api.recal.dev
description: Recal API
security:
- token: []
tags:
- name: Organization
paths:
/v1/organizations:
get:
operationId: getV1Organizations
description: List all organizations
tags:
- Organization
responses:
'200':
description: All organizations
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Organization'
required:
- data
summary: Get V1Organizations
x-summary-source: derived
post:
operationId: postV1Organizations
description: Create a new organization
tags:
- Organization
responses:
'200':
description: Created organization
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Organization'
required:
- data
'400':
description: Validation Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
data:
type: 'null'
required:
- error
- data
'409':
description: Organization with slug already exists
content:
application/json:
schema:
type: object
properties:
data:
type: 'null'
error:
type: string
examples:
- Organization with slug already exists
required:
- data
- error
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
anyOf:
- type: string
maxLength: 128
minLength: 3
- type: 'null'
examples:
- Recal
slug:
type: string
examples:
- recal
pattern: ^[a-z0-9][a-z0-9_-]{2,127}$
required:
- name
- slug
summary: Post V1Organizations
x-summary-source: derived
/v1/organizations/{orgSlug}:
get:
operationId: getV1OrganizationsByOrgSlug
description: Get organization
tags:
- Organization
responses:
'200':
description: Organization
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Organization'
required:
- data
'400':
description: Validation Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
data:
type: 'null'
required:
- error
- data
'404':
description: Organization not found
content:
application/json:
schema:
type: object
properties:
data:
type: 'null'
error:
type: string
examples:
- Organization with slug {orgSlug} not found
required:
- data
- error
parameters:
- in: path
name: orgSlug
schema:
type: string
examples:
- recal
pattern: ^[a-z0-9][a-z0-9_-]{2,127}$
required: true
summary: Get V1Organizations by org slug
x-summary-source: derived
put:
operationId: putV1OrganizationsByOrgSlug
description: Update organization
tags:
- Organization
responses:
'200':
description: Updated organization
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Organization'
required:
- data
'400':
description: Validation Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
data:
type: 'null'
required:
- error
- data
'404':
description: Organization not found
content:
application/json:
schema:
type: object
properties:
data:
type: 'null'
error:
type: string
examples:
- Organization with slug {orgSlug} not found
required:
- data
- error
parameters:
- in: path
name: orgSlug
schema:
type: string
examples:
- recal
pattern: ^[a-z0-9][a-z0-9_-]{2,127}$
required: true
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
anyOf:
- type: string
maxLength: 128
minLength: 3
- type: 'null'
examples:
- Recal
slug:
type: string
examples:
- recal
pattern: ^[a-z0-9][a-z0-9_-]{2,127}$
required:
- name
- slug
summary: Put V1Organizations by org slug
x-summary-source: derived
delete:
operationId: deleteV1OrganizationsByOrgSlug
description: Delete organization
tags:
- Organization
responses:
'200':
description: Deleted organization
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/Organization'
required:
- data
'400':
description: Validation Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
data:
type: 'null'
required:
- error
- data
'404':
description: Organization not found
content:
application/json:
schema:
type: object
properties:
data:
type: 'null'
error:
type: string
examples:
- Organization with slug {orgSlug} not found
required:
- data
- error
parameters:
- in: path
name: orgSlug
schema:
type: string
examples:
- recal
pattern: ^[a-z0-9][a-z0-9_-]{2,127}$
required: true
summary: Delete V1Organizations by org slug
x-summary-source: derived
/v1/organizations/{orgSlug}/members:
get:
operationId: getV1OrganizationsByOrgSlugMembers
description: Get all members of an organization
tags:
- Organization
responses:
'200':
description: All members of an organization
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
createdAt:
type: string
examples:
- '2025-04-24T00:00:00.000Z'
format: date-time
pattern: ^([+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-3])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6])))(T((([01]\d|2[0-3])((:?)[0-5]\d)?|24:?00)([,.]\d+(?!:))?)?(\17[0-5]\d([,.]\d+)?)?([Zz]|([+-])([01]\d|2[0-3]):?([0-5]\d)?)?)?)?$
id:
type: string
examples:
- user_123
oauthConnections:
type: array
items:
$ref: '#/components/schemas/AuthConnection'
organizations:
type: array
items:
$ref: '#/components/schemas/Organization'
required:
- createdAt
- id
required:
- data
'400':
description: Validation Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
data:
type: 'null'
required:
- error
- data
'404':
description: Organization not found
content:
application/json:
schema:
type: object
properties:
data:
type: 'null'
error:
type: string
examples:
- Organization with slug {orgSlug} not found
required:
- data
- error
parameters:
- in: path
name: orgSlug
schema:
type: string
examples:
- recal
pattern: ^[a-z0-9][a-z0-9_-]{2,127}$
required: true
- in: query
name: include
schema:
anyOf:
- type: array
items:
enum:
- oauthConnections
- organizations
- const: oauthConnections
- const: organizations
summary: Get V1Organizations by org slug members
x-summary-source: derived
post:
operationId: postV1OrganizationsByOrgSlugMembers
description: Add users to an organization
tags:
- Organization
responses:
'200':
description: All users are already members of the organization
content:
application/json:
schema:
type: object
properties:
data:
type: string
examples:
- All users are already members of {orgSlug}
required:
- data
'201':
description: n users added successfully to the organization
content:
application/json:
schema:
type: object
properties:
data:
type: string
examples:
- '{n} users added successfully to {orgSlug}'
required:
- data
'400':
description: Validation Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
data:
type: 'null'
required:
- error
- data
'404':
description: Organization not found
content:
application/json:
schema:
type: object
properties:
data:
type: 'null'
error:
type: string
examples:
- Organization with slug {orgSlug} not found
required:
- data
- error
parameters:
- in: path
name: orgSlug
schema:
type: string
examples:
- recal
pattern: ^[a-z0-9][a-z0-9_-]{2,127}$
required: true
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
userIds:
type: array
items:
type: string
examples:
- user_123
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$
required:
- userIds
summary: Post V1Organizations by org slug members
x-summary-source: derived
delete:
operationId: deleteV1OrganizationsByOrgSlugMembers
description: Remove users from an organization
tags:
- Organization
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
data:
type: string
examples:
- Users removed successfully from {orgSlug}
required:
- data
'400':
description: Validation Error
content:
application/json:
schema:
type: object
properties:
error:
type: string
data:
type: 'null'
required:
- error
- data
'404':
description: Organization not found
content:
application/json:
schema:
type: object
properties:
data:
type: 'null'
error:
type: string
examples:
- Organization with slug {orgSlug} not found
required:
- data
- error
parameters:
- in: path
name: orgSlug
schema:
type: string
examples:
- recal
pattern: ^[a-z0-9][a-z0-9_-]{2,127}$
required: true
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
userIds:
type: array
items:
type: string
examples:
- user_123
pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$
required:
- userIds
summary: Delete V1Organizations by org slug members
x-summary-source: derived
components:
schemas:
Organization:
type: object
description: Organization
properties:
createdAt:
type: string
examples:
- '2025-04-24T00:00:00.000Z'
format: date-time
pattern: ^([+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-3])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6])))(T((([01]\d|2[0-3])((:?)[0-5]\d)?|24:?00)([,.]\d+(?!:))?)?(\17[0-5]\d([,.]\d+)?)?([Zz]|([+-])([01]\d|2[0-3]):?([0-5]\d)?)?)?)?$
name:
anyOf:
- type: string
maxLength: 128
minLength: 3
- type: 'null'
examples:
- Recal
slug:
type: string
examples:
- recal
pattern: ^[a-z0-9][a-z0-9_-]{2,127}$
members:
type: array
items:
$ref: '#/components/schemas/User'
required:
- createdAt
- name
- slug
User:
type: object
description: User
properties:
createdAt:
type: string
examples:
- '2025-04-24T00:00:00.000Z'
format: date-time
pattern: ^([+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-3])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6])))(T((([01]\d|2[0-3])((:?)[0-5]\d)?|24:?00)([,.]\d+(?!:))?)?(\17[0-5]\d([,.]\d+)?)?([Zz]|([+-])([01]\d|2[0-3]):?([0-5]\d)?)?)?)?$
id:
type: string
examples:
- user_123
required:
- createdAt
- id
AuthConnection:
type: object
description: OAuth Connection
properties:
alive:
type: boolean
email:
anyOf:
- type: string
pattern: ^[\w%+.-]+@[\d.A-Za-z-]+\.[A-Za-z]{2,}$
format: email
- type: 'null'
expiresAt:
anyOf:
- type: string
pattern: ^([+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-3])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6])))(T((([01]\d|2[0-3])((:?)[0-5]\d)?|24:?00)([,.]\d+(?!:))?)?(\17[0-5]\d([,.]\d+)?)?([Zz]|([+-])([01]\d|2[0-3]):?([0-5]\d)?)?)?)?$
- type: 'null'
format: date-time
provider:
enum:
- google
- microsoft
scope:
type: array
items:
type: string
type:
type: string
accessToken: {}
refreshToken: {}
required:
- alive
- email
- expiresAt
- provider
- scope
- type
securitySchemes:
token:
type: http
scheme: bearer
bearerFormat: recal-token
description: Recal API token