Optimizely Punch Out Order Requests API

The Punch Out Order Requests API from Optimizely — 8 operation(s) for punch out order requests.

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v1/admin/PunchOutOrderRequests List punchout order requests · Returns the EntitySet PunchOutOrderRequests #
Ask an LLM
“Which punchout purchase orders have come in from procurement systems?”
“Can I filter punchout order requests by status or customer PO?”
Tell an agent
List all punchout order requests.
Find punchout order requests matching {filter}.
POST /api/v1/admin/PunchOutOrderRequests Record a punchout order request · Post a new entity to EntitySet PunchOutOrderRequests #
Ask an LLM
“How do I store an incoming cXML punchout order request in the commerce admin?”
“What billing and shipping fields does a new punchout order request need?”
Tell an agent
Record punchout order {orderId} with customer PO {customerPo} and cXML {punchOutOrderRequestCXml}.
Create a punchout order request for order {orderId} totalling {total} {totalCurrency}.
GET /api/v1/admin/PunchOutOrderRequests({id}) Get a punchout order request · Returns the entity with the key from PunchOutOrderRequests #
Ask an LLM
“What are the ship-to and bill-to details of one punchout order request?”
“Which requisition does a specific punchout order request belong to?”
Tell an agent
Get punchout order request {id}.
Show punchout order request {id} with {expand} expanded.
PUT /api/v1/admin/PunchOutOrderRequests({id}) Replace a punchout order request · Replace entity in EntitySet PunchOutOrderRequests #
Ask an LLM
“How do I overwrite a full punchout order request record?”
“Does replacing a punchout order request wipe fields I omit?”
Tell an agent
Replace punchout order request {id} with a full record for order {orderId}.
Overwrite punchout order request {id} with status {status} and customer PO {customerPo}.
DELETE /api/v1/admin/PunchOutOrderRequests({id}) Delete a punchout order request · Delete entity in EntitySet PunchOutOrderRequests #
Ask an LLM
“How do I remove one punchout order request by its ID?”
“Can a punchout order request delete be guarded by an ETag?”
Tell an agent destructive · confirm first
Delete punchout order request {id}.
Delete punchout order request {id} only if its ETag matches {etag}.
PATCH /api/v1/admin/PunchOutOrderRequests({id}) Update a punchout order request · Update entity in EntitySet PunchOutOrderRequests #
Ask an LLM
“Can I change just the status of a punchout order request?”
“How do I correct the ship-to email on a punchout order request?”
Tell an agent
Set the status of punchout order request {id} to {status}.
Change the ship-to email on punchout order request {id} to {shipToEmail}.
GET /api/v1/admin/PunchOutOrderRequests/Default.Default() Get a blank punchout order request template · Call operation Default #
Ask an LLM
“What default values does a new punchout order request start with?”
“Is there an empty punchout order request template I can fetch?”
Tell an agent
Fetch the default punchout order request template.
Show default field values for a new punchout order request.
DELETE /api/v1/admin/punchoutorderrequests/delete Bulk delete punchout order requests · Punch out order requests delete route #
Ask an LLM
“How do I delete many punchout order requests at once?”
“Can I purge a list of punchout order requests by ID in one call?”
Tell an agent destructive · confirm first
Bulk delete punchout order requests {ids}.
Remove these punchout order requests together: {ids}.
GET /api/v1/admin/punchoutorderrequests({key})/customproperties({custompropertyKey}) Get a custom property on a punchout order · Punch out order requests get custom property by key and custompropertykey #
Ask an LLM
“What value is stored in a custom property on a punchout order request?”
“Can I read one custom property from a punchout order request?”
Tell an agent
Get custom property {custompropertyKey} on punchout order request {key}.
Show punchout order request {key}'s custom property {custompropertyKey}.
GET /api/v1/admin/punchoutorderrequests({key})/punchoutorderrequestextrinsics({punchoutorderrequestextrinsicKey}) Get an extrinsic value on a punchout order · Punch out order requests get punch out order request extrinsic by key and… #
Ask an LLM
“Which extrinsic values did the buyer's procurement system send with a punchout order?”
“Can I read one cXML extrinsic entry attached to a punchout order request?”
Tell an agent
Get extrinsic {punchoutorderrequestextrinsicKey} on punchout order request {key}.
Show the cXML extrinsic {punchoutorderrequestextrinsicKey} sent with punchout order {key}.
GET /api/v1/admin/punchoutorderrequests({key})/punchoutorderrequestitemouts({punchoutorderrequestitemoutKey}) Get a line item on a punchout order · Punch out order requests get punch out order request item out by key and… #
Ask an LLM
“What was ordered on a specific line of a punchout order request?”
“Can I look up one ItemOut line from a punchout order?”
Tell an agent
Get item line {punchoutorderrequestitemoutKey} of punchout order request {key}.
Show ItemOut {punchoutorderrequestitemoutKey} on punchout order {key}.
GET /api/v1/admin/punchoutorderrequests({key})/punchoutorderrequestmessages({punchoutorderrequestmessageKey}) Get a validation message on a punchout order · Punch out order requests get punch out order request message by key and… #
Ask an LLM
“Why did a punchout order request fail validation?”
“Can I read one validation message attached to a specific punchout order?”
Tell an agent
Get validation message {punchoutorderrequestmessageKey} on punchout order request {key}.
Show message {punchoutorderrequestmessageKey} recorded against punchout order {key}.

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/optimizely:optimizely-punch-out-order-requests-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.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

optimizely-punch-out-order-requests-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: admin-v1
  title: Admin API V1 Punch Out Order Requests API
servers:
- url: https://dogfood.commerce.insitesandbox.com
security: []
tags:
- name: Punch Out Order Requests
paths:
  /api/v1/admin/PunchOutOrderRequests:
    get:
      tags:
      - Punch Out Order Requests
      summary: Returns the EntitySet PunchOutOrderRequests
      operationId: PunchOutOrderRequests_Get
      parameters:
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $filter
        in: query
        description: Filters the results, based on a Boolean condition.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      - name: $apply
        in: query
        description: Aggregates the results according to one or more transformations.
        required: false
        schema:
          type: string
      - name: $orderby
        in: query
        description: Sorts the results.
        required: false
        schema:
          type: string
      - name: $top
        in: query
        description: Returns only the first n results.
        required: false
        schema:
          type: integer
          format: int32
      - name: $skip
        in: query
        description: Skips the first n results.
        required: false
        schema:
          type: integer
          format: int32
      - name: $count
        in: query
        description: Includes a count of the matching results in the response.
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    post:
      tags:
      - Punch Out Order Requests
      summary: Post a new entity to EntitySet PunchOutOrderRequests
      operationId: PunchOutOrderRequests_Post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.PunchOutOrderRequest'
        description: The entity to post
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/PunchOutOrderRequests({id}):
    get:
      tags:
      - Punch Out Order Requests
      summary: Returns the entity with the key from PunchOutOrderRequests
      operationId: PunchOutOrderRequests_GetById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    put:
      tags:
      - Punch Out Order Requests
      summary: Replace entity in EntitySet PunchOutOrderRequests
      operationId: PunchOutOrderRequests_PutById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.PunchOutOrderRequest'
        description: The entity to put
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    delete:
      tags:
      - Punch Out Order Requests
      summary: Delete entity in EntitySet PunchOutOrderRequests
      operationId: PunchOutOrderRequests_DeleteById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      - name: If-Match
        in: header
        description: If-Match header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    patch:
      tags:
      - Punch Out Order Requests
      summary: Update entity in EntitySet PunchOutOrderRequests
      operationId: PunchOutOrderRequests_PatchById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.PunchOutOrderRequest'
        description: The entity to patch
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/PunchOutOrderRequests/Default.Default():
    get:
      tags:
      - Punch Out Order Requests
      summary: Call operation Default
      operationId: PunchOutOrderRequests_Default
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/punchoutorderrequests/delete:
    delete:
      tags:
      - Punch Out Order Requests
      operationId: PunchOutOrderRequests_DeleteRoute
      parameters:
      - name: ids
        in: query
        required: true
        explode: true
        schema:
          type: array
          items:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Punch out order requests delete route
      x-summary-source: derived
  /api/v1/admin/punchoutorderrequests({key})/customproperties({custompropertyKey}):
    get:
      tags:
      - Punch Out Order Requests
      operationId: PunchOutOrderRequests_GetCustomPropertyByKeyAndCustompropertykey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: custompropertyKey
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Punch out order requests get custom property by key and custompropertykey
      x-summary-source: derived
  /api/v1/admin/punchoutorderrequests({key})/punchoutorderrequestextrinsics({punchoutorderrequestextrinsicKey}):
    get:
      tags:
      - Punch Out Order Requests
      operationId: PunchOutOrderRequests_GetPunchOutOrderRequestExtrinsicByKeyAndPunchoutorderrequestextrinsickey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: punchoutorderrequestextrinsicKey
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Punch out order requests get punch out order request extrinsic by key and…
      x-summary-source: derived
  /api/v1/admin/punchoutorderrequests({key})/punchoutorderrequestitemouts({punchoutorderrequestitemoutKey}):
    get:
      tags:
      - Punch Out Order Requests
      operationId: PunchOutOrderRequests_GetPunchOutOrderRequestItemOutByKeyAndPunchoutorderrequestitemoutkey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: punchoutorderrequestitemoutKey
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Punch out order requests get punch out order request item out by key and…
      x-summary-source: derived
  /api/v1/admin/punchoutorderrequests({key})/punchoutorderrequestmessages({punchoutorderrequestmessageKey}):
    get:
      tags:
      - Punch Out Order Requests
      operationId: PunchOutOrderRequests_GetPunchOutOrderRequestMessageByKeyAndPunchoutorderrequestmessagekey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: punchoutorderrequestmessageKey
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Punch out order requests get punch out order request message by key and…
      x-summary-source: derived
components:
  schemas:
    Insite.Data.Entities.PunchOutOrderRequest:
      required:
      - fromIdentity
      - toIdentity
      - senderIdentity
      - fromUserAgent
      - orderId
      - orderDate
      - orderType
      - orderVersion
      - isInternalVersion
      - agreementId
      - agreementPayloadId
      - parentAgreementId
      - parentAgreementPayloadId
      - effectiveDate
      - expirationDate
      - requisitionId
      - shipComplete
      - releaseRequired
      - type
      - punchOutOrderRequestCXml
      - total
      - totalCurrency
      - shipping
      - shippingCurrency
      - shippingDescription
      - billToAddressId
      - billToName
      - billToStreet
      - billToCity
      - billToState
      - billToPostalCode
      - billToIsoCountryCode
      - billToCountry
      - shipToAddressId
      - shipToName
      - shipToStreet
      - shipToCity
      - shipToState
      - shipToPostalCode
      - shipToIsoCountryCode
      - shipToCountry
      - billToDeliver1
      - shipToDeliver1
      - shipToDeliver2
      - billToDeliver2
      - comments
      - billToEmail
      - shipToEmail
      - billToStreet2
      - billToStreet3
      - billToStreet4
      - billToTelephoneNumber
      - billToTelephoneIsoCountryCode
      - billToTelephoneAreaOrCityCode
      - shipToStreet2
      - shipToStreet3
      - shipToStreet4
      - shipToTelephoneNumber
      - shipToTelephoneIsoCountryCode
      - shipToTelephoneAreaOrCityCode
      - billToTelephoneCountryCode
      - shipToTelephoneCountryCode
      - orderResponse
      - customerPo
      - status
      type: object
      properties:
        id:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        fromIdentity:
          maxLength: 256
          minLength: 0
          type: string
        toIdentity:
          maxLength: 256
          minLength: 0
          type: string
        senderIdentity:
          maxLength: 256
          minLength: 0
          type: string
        fromUserAgent:
          maxLength: 512
          minLength: 0
          type: string
        orderId:
          maxLength: 256
          minLength: 0
          type: string
        orderDate:
          maxLength: 128
          minLength: 0
          type: string
        orderType:
          maxLength: 64
          minLength: 0
          type: string
        orderVersion:
          maxLength: 64
          minLength: 0
          type: string
        isInternalVersion:
          maxLength: 50
          minLength: 0
          type: string
        agreementId:
          maxLength: 64
          minLength: 0
          type: string
        agreementPayloadId:
          maxLength: 64
          minLength: 0
          type: string
        parentAgreementId:
          maxLength: 64
          minLength: 0
          type: string
        parentAgreementPayloadId:
          maxLength: 64
          minLength: 0
          type: string
        effectiveDate:
          maxLength: 64
          minLength: 0
          type: string
        expirationDate:
          maxLength: 64
          minLength: 0
          type: string
        requisitionId:
          maxLength: 64
          minLength: 0
          type: string
        shipComplete:
          maxLength: 50
          minLength: 0
          type: string
        releaseRequired:
          maxLength: 50
          minLength: 0
          type: string
        type:
          maxLength: 64
          minLength: 0
          type: string
        punchOutOrderRequestCXml:
          type: string
        total:
          maxLength: 50
          minLength: 0
          type: string
        totalCurrency:
          maxLength: 50
          minLength: 0
          type: string
        shipping:
          maxLength: 50
          minLength: 0
          type: string
        shippingCurrency:
          maxLength: 50
          minLength: 0
          type: string
        shippingDescription:
          maxLength: 1024
          minLength: 0
          type: string
        billToAddressId:
          maxLength: 50
          minLength: 0
          type: string
        billToName:
          maxLength: 512
          minLength: 0
          type: string
        billToStreet:
          maxLength: 256
          minLength: 0
          type: string
        billToCity:
          maxLength: 128
          minLength: 0
          type: string
        billToState:
          maxLength: 128
          minLength: 0
          type: string
        billToPostalCode:
          maxLength: 50
          minLength: 0
          type: string
        billToIsoCountryCode:
          maxLength: 50
          minLength: 0
          type: string
        billToCountry:
          maxLength: 128
          minLength: 0
          type: string
        shipToAddressId:
          maxLength: 50
          minLength: 0
          type: string
        shipToName:
          maxLength: 512
          minLength: 0
          type: string
        shipToStreet:
          maxLength: 256
          minLength: 0
          type: string
        shipToCity:
          maxLength: 128
          minLength: 0
          type: string
        shipToState:
          maxLength: 128
          minLength: 0
          type: string
        shipToPostalCode:
          maxLength: 50
          minLength: 0
          type: string
        shipToIsoCountryCode:
          maxLength: 50
          minLength: 0
          type: string
        shipToCountry:
          maxLength: 128
          minLength: 0
          type: string
        billToDeliver1:
          maxLength: 128
          minLength: 0
          type: string
        shipToDeliver1:
          maxLength: 128
          minLength: 0
          type: string
        shipToDeliver2:
          maxLength: 128
          minLength: 0
          type: string
        billToDeliver2:
          maxLength: 128
          minLength: 0
          type: string
        comments:
          type: string
        billToEmail:
          maxLength: 1024
          minLength: 0
          type: string
        shipToEmail:
          maxLength: 1024
          minLength: 0
          type: string
        requestUrl:
          type: string
        customerOrderId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        userProfileId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        billToStreet2:
          maxLength: 1024
          minLength: 0
          type: string
        billToStreet3:
          maxLength: 1024
          minLength: 0
          type: string
        billToStreet4:
          maxLength: 1024
          minLength: 0
          type: string
        billToTelephoneNumber:
          maxLength: 50
          minLength: 0
          type: string
        billToTelephoneIsoCountryCode:
          maxLength: 50
          minLength: 0
          type: string
        billToTelephoneAreaOrCityCode:
          maxLength: 50
          minLength: 0
          type: string
        shipToStreet2:
          maxLength: 100
          minLength: 0
          type: string
        shipToStreet3:
          maxLength: 100
          minLength: 0
          type: string
        shipToStreet4:
          maxLength: 100
          minLength: 0
          type: string
        shipToTelephoneNumber:
          maxLength: 50
          minLength: 0
          type: string
        shipToTelephoneIsoCountryCode:
          maxLength: 50
          minLength: 0
          type: string
        shipToTelephoneAreaOrCityCode:
          maxLength: 50
          minLength: 0
          type: string
        punchOutSessionId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        billToTelephoneCountryCode:
          maxLength: 5
          minLength: 0
          type: string
        shipToTelephoneCountryCode:
          maxLength: 5
          minLength: 0
          type: string
        orderResponse:
          type: string
        customerPo:
          maxLength: 256
          minLength: 0
          type: string
        status:
          maxLength: 256
          minLength: 0
          type: string
        createdOn:
          format: date-time
          type: string
        createdBy:
          type: string
        modifiedOn:
          format: date-time
          type: string
        modifiedBy:
          type: string
  securitySchemes:
    access_token:
      type: apiKey
      description: Token used to access storefront API.
      name: access_token
      in: query