Autoposting.ai

Autoposting.ai Organizations API

Create, list, update, and delete organizations (workspaces), including a safeguarded deletion flow with a grace period.

GitHub OpenAPI

Operations 10

POST /orgs Create a new organization #
GET /orgs List organizations the user belongs to #
GET /orgs/me Get current active organization #
PATCH /orgs/me Update current organization #
PUT /orgs/active Switch active organization #
DELETE /orgs/{id} Delete an organization #
POST /orgs/delete-request Initiate deletion (starts grace period) #
POST /orgs/delete-confirm Confirm deletion #
PUT /orgs/delete-cancel Cancel pending deletion #
GET /orgs/delete-status Check deletion status #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/autoposting-ai/openapi/autoposting-ai-organizations-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-api-key-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-agent-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-usage-summary-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-brand-schema.json
📊
JSONSchema
https://artifacts.apis.io/autoposting-ai/json-schema/autoposting-ai-clip-schema.json

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/autoposting-ai:autoposting-ai-organizations-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

autoposting-ai-organizations-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Autoposting Organizations API
  description: 'Schedule, publish, and AI-enhance social content across X, LinkedIn, Instagram, Threads, and YouTube. All responses use the `{ "success": boolean, "data": ... }` envelope. Authenticate with an API key (`Authorization: Bearer sk-social-...` or `x-api-key: sk-social-...`).'
  version: 1.0.0
servers:
- url: https://app.autoposting.ai/api-proxy
  description: Production
security:
- bearerAuth: []
- apiKeyHeader: []
tags:
- name: Organizations
  description: Create, list, update, and delete organizations (workspaces), including a safeguarded deletion flow with a grace period.
paths:
  /orgs:
    post:
      tags:
      - Organizations
      summary: Create a new organization
      operationId: createOrganization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  example: Acme Corp
                slug:
                  type: string
                  example: acme-corp
              required:
              - name
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/Organization'
                required:
                - success
                - data
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
    get:
      tags:
      - Organizations
      summary: List organizations the user belongs to
      operationId: listOrganizations
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: org_01HXYZ
                        name:
                          type: string
                          example: Acme Corp
                        slug:
                          type: string
                          example: acme-corp
                        role:
                          type: string
                          example: owner
                        isActive:
                          type: boolean
                          example: true
                    example:
                    - id: org_01HXYZ
                      name: Acme Corp
                      slug: acme-corp
                      role: owner
                      isActive: true
                    - id: org_02HXYZ
                      name: Side Project
                      slug: side-project
                      role: member
                      isActive: false
                required:
                - success
                - data
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
  /orgs/me:
    get:
      tags:
      - Organizations
      summary: Get current active organization
      operationId: getCurrentOrganization
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    allOf:
                    - $ref: '#/components/schemas/Organization'
                    - type: object
                      properties:
                        memberCount:
                          type: integer
                          example: 5
                        brandCount:
                          type: integer
                          example: 3
                required:
                - success
                - data
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
    patch:
      tags:
      - Organizations
      summary: Update current organization
      operationId: updateOrganization
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  example: Acme Corp
                logoUrl:
                  type: string
                  example: https://cdn.autoposting.ai/logo.png
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                required:
                - success
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
  /orgs/active:
    put:
      tags:
      - Organizations
      summary: Switch active organization
      operationId: switchActiveOrganization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                orgId:
                  type: string
                  example: org_02HXYZ
              required:
              - orgId
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      activeOrgId:
                        type: string
                        example: org_02HXYZ
                required:
                - success
                - data
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
  /orgs/{id}:
    delete:
      tags:
      - Organizations
      summary: Delete an organization
      operationId: deleteOrganization
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                required:
                - success
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
  /orgs/delete-request:
    post:
      tags:
      - Organizations
      summary: Initiate deletion (starts grace period)
      operationId: requestOrganizationDeletion
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                reason:
                  type: string
                  example: No longer needed
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      status:
                        type: string
                        example: pending
                      scheduledDeleteAt:
                        type: string
                        format: date-time
                        example: '2024-01-08T00:00:00Z'
                      cancelBefore:
                        type: string
                        format: date-time
                        example: '2024-01-08T00:00:00Z'
                required:
                - success
                - data
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
  /orgs/delete-confirm:
    post:
      tags:
      - Organizations
      summary: Confirm deletion
      operationId: confirmOrganizationDeletion
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                required:
                - success
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
  /orgs/delete-cancel:
    put:
      tags:
      - Organizations
      summary: Cancel pending deletion
      operationId: cancelOrganizationDeletion
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      status:
                        type: string
                        example: cancelled
                required:
                - success
                - data
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
  /orgs/delete-status:
    get:
      tags:
      - Organizations
      summary: Check deletion status
      operationId: getOrganizationDeletionStatus
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      status:
                        type: string
                        example: pending
                      scheduledDeleteAt:
                        type: string
                        format: date-time
                        example: '2024-01-08T00:00:00Z'
                      requestedAt:
                        type: string
                        format: date-time
                        example: '2024-01-01T00:00:00Z'
                required:
                - success
                - data
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
                    example: unauthorized
                  message:
                    type: string
                    example: Authentication required.
                required:
                - success
                - error
                - message
components:
  schemas:
    Organization:
      type: object
      properties:
        id:
          type: string
          example: org_01HXYZ
        name:
          type: string
          example: Acme Corp
        slug:
          type: string
          example: acme-corp
        ownerId:
          type: string
          example: usr_01HXYZ
        createdAt:
          type: string
          format: date-time
          example: '2024-01-01T00:00:00Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key as `Authorization: Bearer sk-social-...`'
    apiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API key as `x-api-key: sk-social-...`'