openapi: 3.1.0
info:
  title: Accelo REST Activities Companies API
  version: v0
  description: REST API for Accelo's service operations (ServOps) platform. Provides access to companies, contacts, activities, tasks, jobs (projects), issues, invoices, contracts, quotes, prospects, staff, timers, and webhooks. Uses OAuth 2.0 with bearer access tokens, scoped to a deployment subdomain.
  contact:
    name: Accelo
    url: https://www.accelo.com
servers:
- url: https://{deployment}.api.accelo.com/api/v0
  description: Deployment-scoped Accelo API server
  variables:
    deployment:
      default: example
      description: Your Accelo deployment subdomain
security:
- OAuth2: []
tags:
- name: Companies
paths:
  /companies:
    get:
      summary: List companies
      tags:
      - Companies
    post:
      summary: Create a company
      tags:
      - Companies
  /companies/{company_id}:
    get:
      summary: Get a company
      tags:
      - Companies
    put:
      summary: Update a company
      tags:
      - Companies
    delete:
      summary: Delete a company
      tags:
      - Companies
components:
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://{deployment}.api.accelo.com/oauth2/v0/authorize
          tokenUrl: https://{deployment}.api.accelo.com/oauth2/v0/token
          scopes: {}
        clientCredentials:
          tokenUrl: https://{deployment}.api.accelo.com/oauth2/v0/token
          scopes: {}