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.
openapi: 3.2.0
info:
title: Circleci User API
contact:
name: CircleCI Support
url: https://support.circleci.com
termsOfService: https://circleci.com/terms-of-service/
version: '1.0'
description: 'Operations tagged User across 2 of this provider''s published API definitions: circleci-rest-api-v1-openapi.yml, circleci-rest-api-v2-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://circleci.com/api/v1.1
description: CircleCI Production API v1.1
- url: https://circleci.com/api/v2
description: CircleCI Production API
security:
- apiToken: []
tags:
- name: User
description: Endpoints for retrieving information about the authenticated user.
paths:
/me:
get:
operationId: getCurrentUser
summary: Get authenticated user
description: Returns information about the currently authenticated user, including name, login, and avatar URL.
tags:
- User
responses:
'200':
description: Successfully retrieved user information
content:
application/json:
schema:
$ref: '#/components/schemas/User'
'401':
description: Unauthorized
servers:
- url: https://circleci.com/api/v1.1
description: CircleCI Production API v1.1
/me/collaborations:
get:
operationId: getCollaborations
summary: List collaborations
description: Returns a list of organizations and accounts the current user collaborates with.
tags:
- User
responses:
'200':
description: Successfully retrieved collaborations
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Collaboration'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
servers:
- url: https://circleci.com/api/v2
description: CircleCI Production API
components:
schemas:
User:
type: object
properties:
login:
type: string
description: The login name of the user
name:
type: string
description: The display name of the user
avatar_url:
type: string
format: uri
description: URL of the user avatar
admin:
type: boolean
description: Whether the user is an admin
all_emails:
type: array
items:
type: string
format: email
description: All email addresses associated with the user
selected_email:
type: string
format: email
description: The user selected email address
days_left_in_trial:
type: integer
description: Days remaining in trial
parallelism:
type: integer
description: Default parallelism setting
created_at:
type: string
format: date-time
description: When the user account was created
User_2:
type: object
properties:
id:
type: string
format: uuid
description: The unique identifier of the user
login:
type: string
description: The login name of the user
name:
type: string
description: The display name of the user
ErrorResponse:
type: object
properties:
message:
type: string
description: A human-readable error message
Collaboration:
type: object
properties:
vcs-type:
type: string
description: The VCS provider type
name:
type: string
description: The name of the organization
avatar_url:
type: string
format: uri
description: The URL of the organization avatar
slug:
type: string
description: The organization slug
id:
type: string
format: uuid
description: The unique identifier of the organization
securitySchemes:
apiToken:
type: apiKey
in: header
name: Circle-Token
description: Personal API token for authenticating with the CircleCI API. Can also be passed as a query parameter.
basicAuth:
type: http
scheme: basic
description: HTTP basic authentication using a personal API token as the username with an empty password.
x-refined-from:
- circleci-rest-api-v1-openapi.yml
- circleci-rest-api-v2-openapi.yml