Amazon AppSync

Amazon AppSync Appsync Sourceapiassociations API

The Appsync Sourceapiassociations API from Amazon AppSync — 3 operation(s) for appsync sourceapiassociations.

Documentation GitHub OpenAPI

Operations 5

POST /v1/mergedApis/{mergedApiIdentifier}/sourceApiAssociations Associate Source Graphql Api #

DELETE /v1/mergedApis/{mergedApiIdentifier}/sourceApiAssociations/{associationId} Disassociate Source Graphql Api #

GET /v1/mergedApis/{mergedApiIdentifier}/sourceApiAssociations/{associationId} Get Source Api Association #

POST /v1/mergedApis/{mergedApiIdentifier}/sourceApiAssociations/{associationId} Update Source Api Association #

GET /v1/apis/{apiId}/sourceApiAssociations List Source Api Associations #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/amazon-appsync/openapi/amazon-appsync-sourceapiassociations-api-openapi.yml

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/amazon-appsync:amazon-appsync-sourceapiassociations-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: AWS AppSync Sourceapiassociations API
  version: '2017-07-25'
  description: Generated from AWS's published Smithy model for AWS AppSync. 5 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://appsync.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
tags:
- name: Sourceapiassociations
paths:
  /v1/mergedApis/{mergedApiIdentifier}/sourceApiAssociations:
    post:
      operationId: AssociateSourceGraphqlApi
      summary: Associate Source Graphql Api
      description: Creates an association between a Merged API and source API using the Merged API's identifier.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssociateSourceGraphqlApiResponse'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '409':
          description: ConcurrentModificationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConcurrentModificationException'
        '500':
          description: InternalFailureException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalFailureException'
        '429':
          description: LimitExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LimitExceededException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundException'
        '401':
          description: UnauthorizedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssociateSourceGraphqlApiRequest'
      tags:
      - Sourceapiassociations
  /v1/mergedApis/{mergedApiIdentifier}/sourceApiAssociations/{associationId}:
    delete:
      operationId: DisassociateSourceGraphqlApi
      summary: Disassociate Source Graphql Api
      description: Deletes an association between a Merged API and source API using the Merged API's identifier and the association ID.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DisassociateSourceGraphqlApiResponse'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '409':
          description: ConcurrentModificationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConcurrentModificationException'
        '500':
          description: InternalFailureException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalFailureException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundException'
        '401':
          description: UnauthorizedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DisassociateSourceGraphqlApiRequest'
      tags:
      - Sourceapiassociations
    get:
      operationId: GetSourceApiAssociation
      summary: Get Source Api Association
      description: Retrieves a SourceApiAssociation object.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSourceApiAssociationResponse'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '500':
          description: InternalFailureException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalFailureException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundException'
        '401':
          description: UnauthorizedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetSourceApiAssociationRequest'
      tags:
      - Sourceapiassociations
    post:
      operationId: UpdateSourceApiAssociation
      summary: Update Source Api Association
      description: Updates some of the configuration choices of a particular source API association.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateSourceApiAssociationResponse'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '409':
          description: ConcurrentModificationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConcurrentModificationException'
        '500':
          description: InternalFailureException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalFailureException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundException'
        '401':
          description: UnauthorizedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSourceApiAssociationRequest'
      tags:
      - Sourceapiassociations
  /v1/apis/{apiId}/sourceApiAssociations:
    get:
      operationId: ListSourceApiAssociations
      summary: List Source Api Associations
      description: Lists the SourceApiAssociationSummary data.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSourceApiAssociationsResponse'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestException'
        '500':
          description: InternalFailureException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalFailureException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundException'
        '401':
          description: UnauthorizedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListSourceApiAssociationsRequest'
      tags:
      - Sourceapiassociations
components:
  schemas:
    GetSourceApiAssociationRequest:
      type: object
      properties:
        mergedApiIdentifier:
          type: string
          description: The identifier of the AppSync Merged API. This is generated by the AppSync service. In most cases, Merged APIs (especially in your account) only require the API ID value or ARN of the merged API. However, Merged APIs in other accounts (cross-account use cases) strictly require the full resource ARN of the merged API.
        associationId:
          type: string
          description: The ID generated by the AppSync service for the source API association.
      required:
      - mergedApiIdentifier
      - associationId
    SourceApiAssociation:
      type: object
      properties:
        associationId:
          type: string
          description: The ID generated by the AppSync service for the source API association.
        associationArn:
          type: string
          description: The Amazon Resource Name (ARN) of the source API association.
        sourceApiId:
          type: string
          description: The ID of the AppSync source API.
        sourceApiArn:
          type: string
          description: The Amazon Resource Name (ARN) of the AppSync source API.
        mergedApiArn:
          type: string
          description: The Amazon Resource Name (ARN) of the AppSync Merged API.
        mergedApiId:
          type: string
          description: The ID of the AppSync Merged API.
        description:
          type: string
          description: The description field.
        sourceApiAssociationConfig:
          $ref: '#/components/schemas/SourceApiAssociationConfig'
        sourceApiAssociationStatus:
          type: string
          enum:
          - MERGE_SCHEDULED
          - MERGE_FAILED
          - MERGE_SUCCESS
          - MERGE_IN_PROGRESS
          - AUTO_MERGE_SCHEDULE_FAILED
          - DELETION_SCHEDULED
          - DELETION_IN_PROGRESS
          - DELETION_FAILED
          description: The state of the source API association.
        sourceApiAssociationStatusDetail:
          type: string
          description: The detailed message related to the current state of the source API association.
        lastSuccessfulMergeDate:
          type: string
          format: date-time
          description: The datetime value of the last successful merge of the source API association. The result will be in UTC format and your local time zone.
    BadRequestDetail:
      type: object
      properties:
        codeErrors:
          type: array
          items:
            $ref: '#/components/schemas/CodeError'
          description: Contains the list of errors in the request.
    AssociateSourceGraphqlApiRequest:
      type: object
      properties:
        mergedApiIdentifier:
          type: string
          description: The identifier of the AppSync Merged API. This is generated by the AppSync service. In most cases, Merged APIs (especially in your account) only require the API ID value or ARN of the merged API. However, Merged APIs in other accounts (cross-account use cases) strictly require the full resource ARN of the merged API.
        sourceApiIdentifier:
          type: string
          description: The identifier of the AppSync Source API. This is generated by the AppSync service. In most cases, source APIs (especially in your account) only require the API ID value or ARN of the source API. However, source APIs from other accounts (cross-account use cases) strictly require the full resource ARN of the source API.
        description:
          type: string
          description: The description field.
        sourceApiAssociationConfig:
          $ref: '#/components/schemas/SourceApiAssociationConfig'
      required:
      - mergedApiIdentifier
      - sourceApiIdentifier
    ConcurrentModificationException:
      type: object
      properties:
        message:
          type: string
    DisassociateSourceGraphqlApiRequest:
      type: object
      properties:
        mergedApiIdentifier:
          type: string
          description: The identifier of the AppSync Merged API. This is generated by the AppSync service. In most cases, Merged APIs (especially in your account) only require the API ID value or ARN of the merged API. However, Merged APIs in other accounts (cross-account use cases) strictly require the full resource ARN of the merged API.
        associationId:
          type: string
          description: The ID generated by the AppSync service for the source API association.
      required:
      - mergedApiIdentifier
      - associationId
    AssociateSourceGraphqlApiResponse:
      type: object
      properties:
        sourceApiAssociation:
          $ref: '#/components/schemas/SourceApiAssociation'
    LimitExceededException:
      type: object
      properties:
        message:
          type: string
    ListSourceApiAssociationsRequest:
      type: object
      properties:
        apiId:
          type: string
          description: The API ID.
        nextToken:
          type: string
          description: An identifier that was returned from the previous call to this operation, which you can use to return the next set of items in the list.
        maxResults:
          type: integer
          description: The maximum number of results that you want the request to return.
      required:
      - apiId
    ListSourceApiAssociationsResponse:
      type: object
      properties:
        sourceApiAssociationSummaries:
          type: array
          items:
            $ref: '#/components/schemas/SourceApiAssociationSummary'
          description: The SourceApiAssociationSummary object data.
        nextToken:
          type: string
          description: An identifier that was returned from the previous call to this operation, which you can use to return the next set of items in the list.
    BadRequestException:
      type: object
      properties:
        message:
          type: string
        reason:
          type: string
          enum:
          - CODE_ERROR
        detail:
          $ref: '#/components/schemas/BadRequestDetail'
    SourceApiAssociationSummary:
      type: object
      properties:
        associationId:
          type: string
          description: The ID generated by the AppSync service for the source API association.
        associationArn:
          type: string
          description: The Amazon Resource Name (ARN) of the source API association.
        sourceApiId:
          type: string
          description: The ID of the AppSync source API.
        sourceApiArn:
          type: string
          description: The Amazon Resource Name (ARN) of the AppSync Source API.
        mergedApiId:
          type: string
          description: The ID of the AppSync Merged API.
        mergedApiArn:
          type: string
          description: The Amazon Resource Name (ARN) of the AppSync Merged API.
        description:
          type: string
          description: The description field.
    CodeError:
      type: object
      properties:
        errorType:
          type: string
          description: 'The type of code error. Examples include, but aren''t limited to: LINT_ERROR, PARSER_ERROR.'
        value:
          type: string
          description: 'A user presentable error. Examples include, but aren''t limited to: Parsing error: Unterminated string literal.'
        location:
          $ref: '#/components/schemas/CodeErrorLocation'
    CodeErrorLocation:
      type: object
      properties:
        line:
          type: integer
          description: The line number in the code. Defaults to 0 if unknown.
        column:
          type: integer
          description: The column number in the code. Defaults to 0 if unknown.
        span:
          type: integer
          description: The span/length of the error. Defaults to -1 if unknown.
    GetSourceApiAssociationResponse:
      type: object
      properties:
        sourceApiAssociation:
          $ref: '#/components/schemas/SourceApiAssociation'
    InternalFailureException:
      type: object
      properties:
        message:
          type: string
    UnauthorizedException:
      type: object
      properties:
        message:
          type: string
    NotFoundException:
      type: object
      properties:
        message:
          type: string
    SourceApiAssociationConfig:
      type: object
      properties:
        mergeType:
          type: string
          enum:
          - MANUAL_MERGE
          - AUTO_MERGE
          description: The property that indicates which merging option is enabled in the source API association. Valid merge types are MANUAL_MERGE (default) and AUTO_MERGE. Manual merges are the default behavior and require the user to trigger any changes from the source APIs to the merged API manually. Auto merges subscribe the merged API to the changes performed on the source APIs so that any change in the source APIs are also made to the merged API. Auto merges use MergedApiExecutionRoleArn to perform merge operations.
    UpdateSourceApiAssociationResponse:
      type: object
      properties:
        sourceApiAssociation:
          $ref: '#/components/schemas/SourceApiAssociation'
    UpdateSourceApiAssociationRequest:
      type: object
      properties:
        associationId:
          type: string
          description: The ID generated by the AppSync service for the source API association.
        mergedApiIdentifier:
          type: string
          description: The identifier of the AppSync Merged API. This is generated by the AppSync service. In most cases, Merged APIs (especially in your account) only require the API ID value or ARN of the merged API. However, Merged APIs in other accounts (cross-account use cases) strictly require the full resource ARN of the merged API.
        description:
          type: string
          description: The description field.
        sourceApiAssociationConfig:
          $ref: '#/components/schemas/SourceApiAssociationConfig'
      required:
      - associationId
      - mergedApiIdentifier
    DisassociateSourceGraphqlApiResponse:
      type: object
      properties:
        sourceApiAssociationStatus:
          type: string
          enum:
          - MERGE_SCHEDULED
          - MERGE_FAILED
          - MERGE_SUCCESS
          - MERGE_IN_PROGRESS
          - AUTO_MERGE_SCHEDULE_FAILED
          - DELETION_SCHEDULED
          - DELETION_IN_PROGRESS
          - DELETION_FAILED
          description: The state of the source API association.
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: appsync
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/appsync/service/2017-07-25/appsync-2017-07-25.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)