Bitly

Bitly User API

Read and update the authenticated user profile and read the platform limits applied to the account. 3 operation(s), extracted verbatim from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4.json.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

PATCH /user Update the current user's name or default group · Update a User #
Ask an LLM
“Can I change the display name on my own user account?”
“How do I switch which group new links go into by default?”
Tell an agent
Change my user name to {name}.
Set my default group to {default_group_guid}.
GET /user Get the current user's profile · Retrieve a User #
Ask an LLM
“How do I find out which Bitly user my access token belongs to?”
“What is my default group and account name?”
Tell an agent
Show my Bitly user profile.
Tell me who the authenticated user is and what their default group is.
GET /user/platform_limits Check API platform limits and usage counts · Get Platform Limits #
Ask an LLM
“What API rate limits apply to my account and how much have I used?”
“Can I check the platform limit for one specific endpoint path?”
Tell an agent
Show all my platform limits and current counts.
Check the platform limit for the {path} endpoint.

Documentation

📖
Documentation
https://dev.bitly.com/api-reference
📖
APIReference
https://dev.bitly.com/api-reference
📖
GettingStarted
https://dev.bitly.com/docs/getting-started/introduction

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/openapi/bitly-user-api-openapi.yml

Other Resources

🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/collections/bitly-user-api.postman_collection.json
🔗
OpenCollection
https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/collections/bitly-user-api.opencollection.json
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/overlays/bitly-user-overlay.yaml

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/bitly:bitly-user-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bitly-user-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 4.0.0
  title: Bitly User API
  termsOfService: https://bitly.com/pages/terms-of-service
  contact:
    url: https://bitly.is/API-support
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  x-logo:
    url: /v4/header-logo.png
  description: Some subscription plans allow multiple users. Only one user is used for authenticating a call, and these operations apply only to the authenticated user.
servers:
- url: https://api-ssl.bitly.com/v4
security:
- bearerAuth: []
tags:
- name: User
  description: Some subscription plans allow multiple users. Only one user is used for authenticating a call, and these operations apply only to the authenticated user.
paths:
  /user:
    patch:
      summary: Update a User
      description: Update fields in the user
      tags:
      - User
      operationId: updateUser
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserUpdate'
      responses:
        '200':
          description: SUCCESS
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        '400':
          description: BAD_REQUEST
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
        '403':
          description: FORBIDDEN
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Forbidden'
        '404':
          description: NOT_FOUND
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
        '422':
          description: UNPROCESSABLE_ENTITY
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnprocessableEntity'
        '500':
          description: INTERNAL_ERROR
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalError'
        '503':
          description: TEMPORARILY_UNAVAILABLE
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemporarilyUnavailable'
    get:
      summary: Retrieve a User
      description: Returns information for the current authenticated user.
      tags:
      - User
      operationId: getUser
      responses:
        '200':
          description: SUCCESS
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        '403':
          description: FORBIDDEN
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Forbidden'
        '404':
          description: NOT_FOUND
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
        '500':
          description: INTERNAL_ERROR
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalError'
        '503':
          description: TEMPORARILY_UNAVAILABLE
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemporarilyUnavailable'
  /user/platform_limits:
    get:
      summary: Get Platform Limits
      description: Fetch all platform limits and counts available for an organization
      operationId: getPlatformLimits
      parameters:
      - $ref: '#/components/parameters/Path'
      tags:
      - User
      responses:
        '200':
          description: SUCCESS
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformLimits'
        '403':
          description: FORBIDDEN
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Forbidden'
        '404':
          description: NOT_FOUND
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFound'
        '500':
          description: INTERNAL_ERROR
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalError'
        '503':
          description: TEMPORARILY_UNAVAILABLE
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemporarilyUnavailable'
components:
  schemas:
    Forbidden:
      description: FORBIDDEN
      allOf:
      - $ref: '#/components/schemas/Error'
    PlatformLimit:
      type: object
      properties:
        endpoint:
          type: string
        methods:
          type: array
          items:
            $ref: '#/components/schemas/MethodLimit'
    UnprocessableEntity:
      description: UNPROCESSABLE_ENTITY
      allOf:
      - $ref: '#/components/schemas/Error'
    FieldError:
      type: object
      properties:
        field:
          type: string
        error_code:
          type: string
        message:
          type: string
    PlatformLimits:
      type: object
      properties:
        platform_limits:
          type: array
          items:
            $ref: '#/components/schemas/PlatformLimit'
    MethodLimit:
      type: object
      properties:
        name:
          type: string
        limit:
          type: integer
        count:
          type: integer
    Email:
      type: object
      properties:
        email:
          type: string
        is_primary:
          type: boolean
        is_verified:
          type: boolean
    User:
      type: object
      required:
      - login
      - is_active
      - created
      - modified
      - is_2fa_enabled
      - name
      - emails
      - is_sso_user
      properties:
        login:
          type: string
        name:
          type: string
        is_active:
          type: boolean
        created:
          type: string
        modified:
          type: string
        is_sso_user:
          type: boolean
        emails:
          type: array
          items:
            $ref: '#/components/schemas/Email'
        is_2fa_enabled:
          type: boolean
        default_group_guid:
          type: string
    TemporarilyUnavailable:
      description: TEMPORARILY_UNAVAILABLE
      allOf:
      - $ref: '#/components/schemas/Error'
    NotFound:
      description: NOT_FOUND
      allOf:
      - $ref: '#/components/schemas/Error'
    BadRequest:
      description: BAD_REQUEST
      allOf:
      - $ref: '#/components/schemas/Error'
    UserUpdate:
      type: object
      properties:
        name:
          type: string
        default_group_guid:
          type: string
      example:
        name: Chauncey McPufferson
        default_group_guid: Ba1bc23dE4F
    InternalError:
      description: INTERNAL_ERROR
      allOf:
      - $ref: '#/components/schemas/Error'
    Error:
      type: object
      properties:
        message:
          type: string
        description:
          type: string
        resource:
          type: string
        errors:
          type: array
          items:
            $ref: '#/components/schemas/FieldError'
  parameters:
    Path:
      name: path
      description: The specific path for which information is requested
      in: query
      schema:
        type: string
      example: /organizations/{organization_guid}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer