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/cogram-com:cogram-com-project-templates-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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: Cogram Project Templates API
  description: 'API for integrating with Cogram. Every key is scoped to one organization.


    - **Auth**: `Authorization: Bearer `. Admins mint keys in Organization

    Settings → Integrations → API Keys.

    - **Pagination**: `page` (1-indexed) + `page_size` (default 50, max 100); returns

    `{"data": [...], "total": N, "page": N, "page_size": N}`. `total` = all matches.

    - **Errors**: `{"error": "", "message": ""}`. Branch on `error`; `message`

    wording may change.

    - **Rate limit**: per key, 1000 req/min by default. `429` carries `Retry-After`,

    `X-RateLimit-Limit`, `X-RateLimit-Remaining`.

    - **Attribution**: optional `X-Forwarded-User` header (≤200 chars) names the end user

    behind the call in Cogram''s audit trail.


    See API documentation for guides and examples.'
  version: v1
servers:
- url: /v1
tags:
- name: project-templates
  description: 'Reusable project setups: a project type plus groups with roles, applied when a project is created with a template_id.'
paths:
  /project-templates:
    get:
      tags:
      - project-templates
      summary: List project templates
      description: List project templates in the organization, ordered by name.
      operationId: external_list_project_templates_route_project_templates_get
      security:
      - HTTPBearer: []
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Page number (1-indexed).
          default: 1
          title: Page
        description: Page number (1-indexed).
      - name: page_size
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 50
          title: Page Size
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectTemplateListV1'
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                error: api_key_invalid
                message: Invalid API key
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '403':
          description: Forbidden
          content:
            application/json:
              example:
                error: forbidden
                message: The API key's creator is not allowed to do this
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '422':
          description: Validation error
          content:
            application/json:
              example:
                error: validation_error
                message: 'body -> name: Field required'
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              example:
                error: rate_limit_exceeded
                message: Rate limit exceeded. Please try again later.
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '500':
          description: Internal server error
          content:
            application/json:
              example:
                error: internal_error
                message: An internal error occurred
              schema:
                $ref: '#/components/schemas/ErrorV1'
    post:
      tags:
      - project-templates
      summary: Create project template
      description: Create a project template. Requires an org admin or owner key creator.
      operationId: external_create_project_template_route_project_templates_post
      security:
      - HTTPBearer: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProjectTemplateWriteV1'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectTemplateV1'
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                error: api_key_invalid
                message: Invalid API key
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '403':
          description: Forbidden
          content:
            application/json:
              example:
                error: forbidden
                message: The API key's creator is not allowed to do this
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '409':
          description: Conflict
          content:
            application/json:
              example:
                error: conflict
                message: Resource already exists
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '422':
          description: Validation error
          content:
            application/json:
              example:
                error: validation_error
                message: 'body -> name: Field required'
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              example:
                error: rate_limit_exceeded
                message: Rate limit exceeded. Please try again later.
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '500':
          description: Internal server error
          content:
            application/json:
              example:
                error: internal_error
                message: An internal error occurred
              schema:
                $ref: '#/components/schemas/ErrorV1'
  /project-templates/{template_id}:
    get:
      tags:
      - project-templates
      summary: Get project template
      description: Get a project template with its group bindings.
      operationId: external_get_project_template_route_project_templates__template_id__get
      security:
      - HTTPBearer: []
      parameters:
      - name: template_id
        in: path
        required: true
        schema:
          type: string
          title: Template Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectTemplateV1'
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                error: api_key_invalid
                message: Invalid API key
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '403':
          description: Forbidden
          content:
            application/json:
              example:
                error: forbidden
                message: The API key's creator is not allowed to do this
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '404':
          description: Not found
          content:
            application/json:
              example:
                error: not_found
                message: Resource not found
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '422':
          description: Validation error
          content:
            application/json:
              example:
                error: validation_error
                message: 'body -> name: Field required'
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              example:
                error: rate_limit_exceeded
                message: Rate limit exceeded. Please try again later.
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '500':
          description: Internal server error
          content:
            application/json:
              example:
                error: internal_error
                message: An internal error occurred
              schema:
                $ref: '#/components/schemas/ErrorV1'
    put:
      tags:
      - project-templates
      summary: Replace project template
      description: 'Replace every field and group binding of a project template.


        Projects already created from the template are not changed. Requires an

        org admin or owner key creator.'
      operationId: external_update_project_template_route_project_templates__template_id__put
      security:
      - HTTPBearer: []
      parameters:
      - name: template_id
        in: path
        required: true
        schema:
          type: string
          title: Template Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProjectTemplateWriteV1'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectTemplateV1'
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                error: api_key_invalid
                message: Invalid API key
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '403':
          description: Forbidden
          content:
            application/json:
              example:
                error: forbidden
                message: The API key's creator is not allowed to do this
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '404':
          description: Not found
          content:
            application/json:
              example:
                error: not_found
                message: Resource not found
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '409':
          description: Conflict
          content:
            application/json:
              example:
                error: conflict
                message: Resource already exists
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '422':
          description: Validation error
          content:
            application/json:
              example:
                error: validation_error
                message: 'body -> name: Field required'
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              example:
                error: rate_limit_exceeded
                message: Rate limit exceeded. Please try again later.
              schema:
                $ref: '#/components/schemas/ErrorV1'
        '500':
          description: Internal server error
          content:
            application/json:
              example:
                error: internal_error
                message: An internal error occurred
              schema:
                $ref: '#/components/schemas/ErrorV1'
components:
  schemas:
    ProjectTemplateGroupV1:
      properties:
        group_id:
          type: string
          title: Group Id
        group_name:
          type: string
          title: Group Name
        role:
          type: string
          enum:
          - LEAD
          - MEMBER
          - VIEWER
          title: ProjectGroupRole
          description: 'Roles a group can hold on a project. OWNER stays direct-only by design;

            LEAD may be granted via a group (gated behind the project-lead-role flag at

            the assignment routes, like a direct LEAD).'
        member_count:
          type: integer
          title: Member Count
      type: object
      required:
      - group_id
      - group_name
      - role
      - member_count
      title: ProjectTemplateGroupV1
      description: A group bound to a template.
    ProjectTemplateGroupInV1:
      properties:
        group_id:
          type: string
          maxLength: 64
          title: Group Id
        role:
          type: string
          maxLength: 64
          title: Role
          description: MEMBER, VIEWER, or LEAD.
      type: object
      required:
      - group_id
      - role
      title: ProjectTemplateGroupInV1
      description: A group to add to every project created from the template.
    ProjectTemplateListV1:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ProjectTemplateSummaryV1'
          type: array
          title: Data
        total:
          type: integer
          title: Total
          description: Total matches across all pages, not just this page.
        page:
          type: integer
          title: Page
        page_size:
          type: integer
          title: Page Size
      type: object
      required:
      - data
      - total
      - page
      - page_size
      title: ProjectTemplateListV1
      description: Paginated project-template list response.
    ErrorCode:
      type: string
      enum:
      - api_key_missing
      - api_key_invalid_format
      - api_key_invalid
      - api_key_expired
      - bad_request
      - forbidden
      - not_found
      - method_not_allowed
      - conflict
      - validation_error
      - rate_limit_exceeded
      - internal_error
      - range_too_large
      - data_export_in_progress
      title: ErrorCode
      description: Error codes for external API v1.
    ProjectTemplateWriteV1:
      properties:
        name:
          type: string
          maxLength: 100
          minLength: 1
          title: Name
          description: Unique within the org (case-insensitive).
        description:
          anyOf:
          - type: string
            maxLength: 2000
          - type: 'null'
          title: Description
        groups:
          items:
            $ref: '#/components/schemas/ProjectTemplateGroupInV1'
          type: array
          maxItems: 500
          title: Groups
        project_type_id:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Project Type Id
        email_filing_enabled_default:
          type: boolean
          title: Email Filing Enabled Default
          default: false
        is_public_default:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Is Public Default
      type: object
      required:
      - name
      title: ProjectTemplateWriteV1
      description: Create or replace a project template. Every field is written.
    ErrorV1:
      properties:
        error:
          $ref: '#/components/schemas/ErrorCode'
          description: Stable machine-readable code. Branch on this.
        message:
          type: string
          title: Message
          description: Human-readable detail. Wording may change.
      type: object
      required:
      - error
      - message
      title: ErrorV1
      description: 'JSON body format for all API v1 error responses.


        This model controls the actual serialization of error responses:

        {"error": "not_found", "message": "Project ''xyz'' not found"}'
    ProjectTemplateSummaryV1:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        group_count:
          type: integer
          title: Group Count
        created_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Created At
        updated_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Updated At
          description: Null if never updated.
      type: object
      required:
      - id
      - name
      - description
      - group_count
      - created_at
      - updated_at
      title: ProjectTemplateSummaryV1
      description: Project template, as listed.
    ProjectTemplateV1:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        groups:
          items:
            $ref: '#/components/schemas/ProjectTemplateGroupV1'
          type: array
          title: Groups
        project_type_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Project Type Id
        email_filing_enabled_default:
          type: boolean
          title: Email Filing Enabled Default
        is_public_default:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Is Public Default
        created_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Created At
        updated_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Updated At
          description: Null if never updated.
      type: object
      required:
      - id
      - name
      - description
      - groups
      - project_type_id
      - email_filing_enabled_default
      - is_public_default
      - created_at
      - updated_at
      title: ProjectTemplateV1
      description: Project template with its group bindings.
  securitySchemes:
    HTTPBearer:
      type: http
      description: Organization API key. Minted by admins in Organization Settings → Integrations → API Keys; shown once, may carry an expiry.
      scheme: bearer
      bearerFormat: Cogram organization API key