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/front-signatures-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:
  version: 1.0.0
  title: Channel Accounts Signatures API
  contact:
    name: Front Platform
    url: https://community.front.com
servers:
- url: https://api2.frontapp.com
security:
- http: []
tags:
- name: Signatures
paths:
  /signatures/{signature_id}:
    get:
      summary: Get signatures
      operationId: get-signatures
      description: 'Get the given signature.


        Required scope: `signatures:read`'
      tags:
      - Signatures
      parameters:
      - in: path
        name: signature_id
        required: true
        description: The signature ID
        schema:
          type: string
          default: sig_123
      responses:
        '200':
          $ref: '#/components/responses/signature'
      x-required-scopes:
      - signatures:read
    patch:
      summary: Update signature
      operationId: update-signature
      description: 'Update signature


        Required scope: `signatures:write`'
      tags:
      - Signatures
      requestBody:
        description: Signature to update
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSignature'
      parameters:
      - in: path
        name: signature_id
        required: true
        description: The signature ID
        schema:
          type: string
          default: sig_123
      responses:
        '200':
          $ref: '#/components/responses/signature'
      x-required-scopes:
      - signatures:write
    delete:
      summary: Delete signature
      operationId: delete-signature
      description: 'Delete signature


        Required scope: `signatures:delete`'
      tags:
      - Signatures
      parameters:
      - in: path
        name: signature_id
        required: true
        description: The signature ID
        schema:
          type: string
          default: sig_123
      responses:
        '204':
          description: No content
      x-required-scopes:
      - signatures:delete
  /teammates/{teammate_id}/signatures:
    get:
      summary: List teammate signatures
      operationId: list-teammate-signatures
      description: 'List the signatures belonging to the given teammate.


        Required scope: `signatures:read`'
      tags:
      - Signatures
      parameters:
      - in: path
        name: teammate_id
        required: true
        description: The teammate ID. Alternatively, you can supply an email as a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1).
        schema:
          type: string
          default: tea_123
      responses:
        '200':
          $ref: '#/components/responses/listOfSignatures'
      x-required-scopes:
      - signatures:read
    post:
      summary: Create teammate signature
      operationId: create-teammate-signature
      description: 'Create a new signature for the given teammate


        Required scope: `signatures:write`'
      tags:
      - Signatures
      requestBody:
        description: Signature to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePrivateSignature'
      parameters:
      - in: path
        name: teammate_id
        required: true
        description: The teammate ID. Alternatively, you can supply an email as a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1).
        schema:
          type: string
          default: tea_123
      responses:
        '201':
          $ref: '#/components/responses/signature'
      x-required-scopes:
      - signatures:write
  /teams/{team_id}/signatures:
    get:
      summary: List team signatures
      operationId: list-team-signatures
      description: 'List the signatures belonging to the given team (workspace).


        Required scope: `signatures:read`'
      tags:
      - Signatures
      parameters:
      - in: path
        name: team_id
        required: true
        description: The team ID
        schema:
          type: string
          default: tim_123
      responses:
        '200':
          $ref: '#/components/responses/listOfSignatures'
      x-required-scopes:
      - signatures:read
    post:
      summary: Create team signature
      operationId: create-team-signature
      description: 'Create a new signature for the given team (workspace).


        Required scope: `signatures:write`'
      tags:
      - Signatures
      requestBody:
        description: Signature to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSharedSignature'
      parameters:
      - in: path
        name: team_id
        required: true
        description: The team ID
        schema:
          type: string
          default: tim_123
      responses:
        '201':
          $ref: '#/components/responses/signature'
      x-required-scopes:
      - signatures:write
components:
  schemas:
    UpdateSignature:
      type: object
      description: A signature that can be used to sign messages.
      properties:
        name:
          type: string
          description: Name of the signature
        sender_info:
          type: string
          description: Sender info of the signature that will appear in the From line of emails sent.
        body:
          type: string
          description: Body of the signature
        is_visible_for_all_teammate_channels:
          type: boolean
          description: Whether or not the signature is visible in all individual channels for teammates in the given team. Can only be set for shared signatures.
        is_default:
          type: boolean
          description: If true, the signature will be set as the default signature for the team or teammate.
          default: false
        channel_ids:
          type: array
          description: The specific shared channels this signature if available in. If null, then it will be available in all channels. If unspecified, will retain previous value. Alternatively, you can specify channels using a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1).
          items:
            type: string
    CreatePrivateSignature:
      type: object
      description: A signature that can be used to sign messages.
      required:
      - name
      - body
      properties:
        name:
          type: string
          description: Name of the signature
        sender_info:
          type: string
          description: Sender info of the signature that will appear in the From line of emails sent.
        body:
          type: string
          description: Body of the signature
        is_default:
          type: boolean
          description: If true, the signature will be set as the default signature for the teammate.
          default: false
        channel_ids:
          type: array
          description: The specific channels this signature is available in. If omitted or null, the signature will be available in all channels the teammate has access to. Alternatively, you can specify channels using a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1).
          items:
            type: string
    SignatureResponse:
      type: object
      required:
      - _links
      - id
      - name
      - body
      - sender_info
      - is_private
      - is_visible_for_all_teammate_channels
      - is_default
      - channel_ids
      properties:
        _links:
          type: object
          properties:
            self:
              type: string
              description: Link to resource
              example: https://yourCompany.api.frontapp.com/signatures/sig_6rrv2
            related:
              type: object
              properties:
                owner:
                  type: string
                  description: Link to signature's owner (either a team or teammate)
                  example: https://yourCompany.api.frontapp.com/teams/tim_k30
        id:
          type: string
          description: Unique identifier of the signature
          example: sig_6rrv2
        name:
          type:
          - string
          - 'null'
          description: Name of the signature
          example: Finer Things Club signature
        body:
          type: string
          description: Body of the signature
          example: <div>—<br />{{user.name}}<br />No paper, no plastic, and no work talk allowed<br /></div>
        sender_info:
          type:
          - string
          - 'null'
          description: Sender info of the signature
          example:
            '[object Object]': null
        is_visible_for_all_teammate_channels:
          type: boolean
          description: Whether or not the signature is available in teammate channels.
          example: true
        is_default:
          type: boolean
          description: Whether the signature is the default signature for the team or teammate.
          example: false
        is_private:
          type: boolean
          description: Whether the signature is private to the teammate.
          example: true
        channel_ids:
          type:
          - array
          - 'null'
          items:
            type: string
            description: List of channels the signature is available in. If belonging to a teammate, represents all channels this can be used in. If belonging to a team, represents all team channels this can be used in. If null, there are no restrictions.
            example: null
    CreateSharedSignature:
      type: object
      description: A signature that can be used to sign messages.
      required:
      - name
      - body
      properties:
        name:
          type: string
          description: Name of the signature
        sender_info:
          type: string
          description: Sender info of the signature that will appear in the From line of emails sent.
        body:
          type: string
          description: Body of the signature
        is_visible_for_all_teammate_channels:
          type: boolean
          description: Whether or not the signature is visible in all individual channels for teammates in the given team.
        is_default:
          type: boolean
          description: If true, the signature will be set as the default signature for the team.
          default: false
        channel_ids:
          type: array
          description: The specific channels this signature is available in. If omitted or null, the signature will be available in all channels the team has access to. Alternatively, you can specify channels using a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1).
          items:
            type: string
  responses:
    listOfSignatures:
      description: Array of signatures
      content:
        application/json:
          schema:
            type: object
            properties:
              _pagination:
                type: object
                properties:
                  next:
                    type:
                    - string
                    - 'null'
                    description: Link to next [page of results](https://dev.frontapp.com/docs/pagination)
                    example: https://yourCompany.api.frontapp.com/signatures?page_token=9fa92a7f385fd7be43f7153055b30e6d
              _links:
                type: object
                properties:
                  self:
                    type: string
                    description: Link to resource
                    example: https://yourCompany.api.frontapp.com/signatures
              _results:
                type: array
                items:
                  $ref: '#/components/schemas/SignatureResponse'
    signature:
      description: A signature
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SignatureResponse'
  securitySchemes:
    http:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-api-id: front
x-explorer-enabled: false
x-proxy-enabled: true
x-samples-enabled: true