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/aginera-ai:aginera-ai-projects-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

openapi: 3.2.0
info:
  title: Aginera Ai Projects API
  version: 1.0.0-rc.1
  contact:
    name: Aginera Developer Support
    email: developers@aginera.ai
    url: https://aginera.ai/docs/developer
  license:
    name: Proprietary — Aginera Developer Platform Terms
    url: https://aginera.ai/legal/developer-terms
  termsOfService: https://aginera.ai/legal/developer-terms
  description: 'Operations tagged Projects across 3 of this provider''s published API definitions: aginera-ai-openapi.json, aginera-openapi.json, aginera-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.aginera.ai/partner/v1
  description: Production and sandbox (environment is per credential)
security:
- oauth2: []
tags:
- name: Projects
  description: Foundation — containers for documents and takeoffs.
paths:
  /projects:
    post:
      operationId: projects.create
      summary: Create a project
      tags:
      - Projects
      security:
      - oauth2:
        - projects:write
      x-aginera-cut: core
      parameters:
      - schema:
          type: string
          description: Replays within 24 hours return the original response.
        required: false
        name: Idempotency-Key
        in: header
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProjectCreate'
      responses:
        '201':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Project'
        default:
          description: Error (RFC 7807)
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                $ref: '#/components/schemas/Problem'
    get:
      operationId: projects.list
      summary: List projects
      tags:
      - Projects
      security:
      - oauth2:
        - projects:read
      x-aginera-cut: core
      parameters:
      - schema:
          type: integer
          minimum: 1
          maximum: 200
          default: 50
        required: false
        name: limit
        in: query
      - schema:
          type: string
          maxLength: 512
        required: false
        name: cursor
        in: query
      - schema:
          type: string
          maxLength: 128
        required: false
        name: end_customer_ref
        in: query
      - schema:
          type: string
          maxLength: 128
        required: false
        name: external_ref
        in: query
      - schema:
          type: string
          maxLength: 200
        required: false
        name: q
        in: query
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectList'
        default:
          description: Error (RFC 7807)
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                $ref: '#/components/schemas/Problem'
    servers:
    - url: https://api.aginera.ai/partner/v1
      description: Production and sandbox (environment is per credential)
  /projects/{project_id}:
    get:
      operationId: projects.get
      summary: Get a project
      tags:
      - Projects
      security:
      - oauth2:
        - projects:read
      x-aginera-cut: core
      parameters:
      - schema:
          $ref: '#/components/schemas/ProjectId'
        required: true
        name: project_id
        in: path
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Project'
        default:
          description: Error (RFC 7807)
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                $ref: '#/components/schemas/Problem'
    patch:
      operationId: projects.update
      summary: Update a project
      tags:
      - Projects
      security:
      - oauth2:
        - projects:write
      x-aginera-cut: core
      parameters:
      - schema:
          $ref: '#/components/schemas/ProjectId'
        required: true
        name: project_id
        in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProjectUpdate'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Project'
        default:
          description: Error (RFC 7807)
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                $ref: '#/components/schemas/Problem'
    delete:
      operationId: projects.delete
      summary: Delete a project and its documents
      tags:
      - Projects
      security:
      - oauth2:
        - projects:delete
      x-aginera-cut: core
      parameters:
      - schema:
          $ref: '#/components/schemas/ProjectId'
        required: true
        name: project_id
        in: path
      responses:
        '204':
          description: No content
        default:
          description: Error (RFC 7807)
          content:
            application/problem+json:
              schema:
                type: object
                properties: {}
                $ref: '#/components/schemas/Problem'
    servers:
    - url: https://api.aginera.ai/partner/v1
      description: Production and sandbox (environment is per credential)
components:
  schemas:
    Metadata:
      type: object
      additionalProperties:
        type: string
        maxLength: 500
    Project:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/ProjectId'
        name:
          type: string
        reference:
          type:
          - string
          - 'null'
        end_customer_ref:
          type:
          - string
          - 'null'
        external_ref:
          type:
          - string
          - 'null'
        address:
          type:
          - string
          - 'null'
        metadata:
          type: object
          additionalProperties:
            type: string
        document_count:
          type: integer
        created_at:
          type: string
          format: date-time
        updated_at:
          type:
          - string
          - 'null'
          format: date-time
      required:
      - id
      - name
      - reference
      - end_customer_ref
      - external_ref
      - address
      - metadata
      - document_count
      - created_at
      - updated_at
    ProjectId:
      type: string
      pattern: ^prj_[0-9A-Za-z]{22}$
      example: prj_4kR9sT2vWx7yZa1bCd3eFg
    ProjectCreate:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 200
        reference:
          type: string
          maxLength: 100
        end_customer_ref:
          type: string
          maxLength: 128
          description: Identifier of your customer, used in usage reports.
        external_ref:
          type: string
          minLength: 1
          maxLength: 128
          description: Your own identifier for this resource; unique per tenant.
        address:
          type: string
          maxLength: 500
        metadata:
          $ref: '#/components/schemas/Metadata'
      required:
      - name
      additionalProperties: false
    ProjectList:
      type: object
      properties:
        next_cursor:
          type:
          - string
          - 'null'
        has_more:
          type: boolean
        data:
          type: array
          items:
            $ref: '#/components/schemas/Project'
      required:
      - next_cursor
      - has_more
      - data
    Problem:
      type: object
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        code:
          type: string
        detail:
          type: string
        request_id:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
            required:
            - field
            - message
        required_credits:
          type: number
        available_credits:
          type: number
        quota:
          type: string
        retry_after:
          type: integer
        next_step:
          type: string
      required:
      - type
      - title
      - status
      - code
      - detail
      - request_id
    ProjectUpdate:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 200
        reference:
          type: string
          maxLength: 100
        end_customer_ref:
          type: string
          maxLength: 128
          description: Identifier of your customer, used in usage reports.
        external_ref:
          type: string
          minLength: 1
          maxLength: 128
          description: Your own identifier for this resource; unique per tenant.
        address:
          type: string
          maxLength: 500
        metadata:
          $ref: '#/components/schemas/Metadata'
      additionalProperties: false
  securitySchemes:
    oauth2:
      type: oauth2
      description: Client credentials (service mode, Microsoft Entra ID tenant of Aginera; request scope=api://<aginera-api-app-id>/.default; granular scopes are attached to the credential) or authorization code + PKCE (delegated mode via the Aginera authorization server; scopes are consented by the user).
      flows:
        clientCredentials:
          tokenUrl: https://login.microsoftonline.com/65f567a9-6e6a-4f81-863c-aea4ece1f8eb/oauth2/v2.0/token
          scopes:
            projects:read: View projects
            projects:write: Create and update projects
            projects:delete: Delete projects
            documents:read: View and download documents
            documents:write: Upload drawings
            documents:delete: Delete documents
            takeoffs:read: View takeoffs, items, routes and schedules
            takeoffs:run: Run takeoffs (uses credits)
            takeoffs:review: Accept, reject or adjust takeoff items
            takeoffs:delete: Delete takeoffs
            estimates:read: View estimates
            estimates:generate: Generate estimates (uses credits)
            exports:read: Download exports
            exports:create: Create exports
            billing:read: View credits and usage
            billing:write: Purchase credits
            events:read: Read the event log
            webhooks:manage: Manage webhook endpoints
            takeoffs:deep: Run deep (UI-parity) takeoffs
            interior:read: View floor-plan renders (dollhouse, room images, film)
            interior:generate: Render floor plans and start purchases on your account (uses credits; paid add-ons need your checkout)
            cad:convert: Convert PDF drawings to CAD (free to view; downloading the CAD file is a one-time purchase — paid from your credits only when you say so, otherwise via your own checkout)
            bim:read: View BIM coordination models
            bim:generate: Generate BIM models + embed URLs (uses credits)
            clash:run: Run clash detection + embed URLs (uses credits)
        authorizationCode:
          authorizationUrl: https://auth.aginera.ai/oauth/authorize
          tokenUrl: https://auth.aginera.ai/oauth/token
          refreshUrl: https://auth.aginera.ai/oauth/token
          scopes:
            projects:read: View projects
            projects:write: Create and update projects
            projects:delete: Delete projects
            documents:read: View and download documents
            documents:write: Upload drawings
            documents:delete: Delete documents
            takeoffs:read: View takeoffs, items, routes and schedules
            takeoffs:run: Run takeoffs (uses credits)
            takeoffs:review: Accept, reject or adjust takeoff items
            takeoffs:delete: Delete takeoffs
            estimates:read: View estimates
            estimates:generate: Generate estimates (uses credits)
            exports:read: Download exports
            exports:create: Create exports
            billing:read: View credits and usage
            billing:write: Purchase credits
            events:read: Read the event log
            webhooks:manage: Manage webhook endpoints
            takeoffs:deep: Run deep (UI-parity) takeoffs
            interior:read: View floor-plan renders (dollhouse, room images, film)
            interior:generate: Render floor plans and start purchases on your account (uses credits; paid add-ons need your checkout)
            cad:convert: Convert PDF drawings to CAD (free to view; downloading the CAD file is a one-time purchase — paid from your credits only when you say so, otherwise via your own checkout)
            bim:read: View BIM coordination models
            bim:generate: Generate BIM models + embed URLs (uses credits)
            clash:run: Run clash detection + embed URLs (uses credits)
x-refined-from:
- aginera-ai-openapi.json
- aginera-openapi.json
- aginera-openapi.yaml