AimRank Collaborators API
The Collaborators API from AimRank — 5 operation(s) for collaborators.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/aimrank-io:aimrank-io-collaborators-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API 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 Specification
openapi: 3.2.0
info:
title: AimRank Collaborators API
description: Ranking-as-a-Service API — Turn binary comparisons into calibrated rankings with Glicko-2, Bradley-Terry, TrueSkill, and cross-domain transfer learning. Includes webhooks, API keys, RLHF exports, and embeddable widgets.
version: 4.12.0
tags:
- name: Collaborators
paths:
/api/v1/rankings/my-invitations:
get:
tags:
- Collaborators
summary: Get My Invitations
description: List pending collaboration invitations for the current user.
operationId: get_my_invitations_api_v1_rankings_my_invitations_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
/api/v1/rankings/{ranking_id}/collaborators:
get:
tags:
- Collaborators
summary: List Collaborators
description: List all collaborators for a ranking (includes owner).
operationId: list_collaborators_api_v1_rankings__ranking_id__collaborators_get
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- Collaborators
summary: Invite Collaborator
description: Invite a user as a collaborator on a ranking.
operationId: invite_collaborator_api_v1_rankings__ranking_id__collaborators_post
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/InviteRequest'
responses:
'201':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/rankings/{ranking_id}/collaborators/bulk:
post:
tags:
- Collaborators
summary: Bulk Invite Collaborators
description: 'Invite many users at once. Atomic per-user — failures don''t block the rest.
Used for onboarding an org''s coaching staff or judging panel in one shot.
The caller must have at least ''moderate'' permission on the ranking, and
moderators may only invite contributors (same rule as single-invite).'
operationId: bulk_invite_collaborators_api_v1_rankings__ranking_id__collaborators_bulk_post
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BulkInviteRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BulkInviteResult'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/rankings/{ranking_id}/collaborators/accept:
post:
tags:
- Collaborators
summary: Accept Invitation
description: Accept a pending collaboration invitation.
operationId: accept_invitation_api_v1_rankings__ranking_id__collaborators_accept_post
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/rankings/{ranking_id}/collaborators/{user_id}:
put:
tags:
- Collaborators
summary: Update Collaborator Role
description: Change a collaborator's role (owner only).
operationId: update_collaborator_role_api_v1_rankings__ranking_id__collaborators__user_id__put
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
- name: user_id
in: path
required: true
schema:
type: string
title: User Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RoleUpdateRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- Collaborators
summary: Remove Collaborator
description: Remove a collaborator (owner can remove anyone, users can leave).
operationId: remove_collaborator_api_v1_rankings__ranking_id__collaborators__user_id__delete
parameters:
- name: ranking_id
in: path
required: true
schema:
type: string
title: Ranking Id
- name: user_id
in: path
required: true
schema:
type: string
title: User Id
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
InviteRequest:
properties:
email_or_username:
type: string
title: Email Or Username
role:
type: string
title: Role
default: contributor
type: object
required:
- email_or_username
title: InviteRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
BulkInviteRequest:
properties:
invitees:
items:
type: string
type: array
title: Invitees
role:
type: string
title: Role
default: contributor
type: object
required:
- invitees
title: BulkInviteRequest
description: Invite many users at once. Used by org owners onboarding a coaching staff.
RoleUpdateRequest:
properties:
role:
type: string
title: Role
type: object
required:
- role
title: RoleUpdateRequest
BulkInviteResult:
properties:
invited:
type: integer
title: Invited
already_active:
type: integer
title: Already Active
not_found:
items:
type: string
type: array
title: Not Found
skipped_self_or_owner:
items:
type: string
type: array
title: Skipped Self Or Owner
type: object
required:
- invited
- already_active
- not_found
- skipped_self_or_owner
title: BulkInviteResult
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key