provisioning

Adds a new Task Order (TO)

Adds a new Task Order to an existing Portfolio

post/portfolios/{portfolioId}/task-orders

Request body

idstring required

Represents the unique ID of a Task Order. Must be defined by CSPs upon object creation.

task_order_numberstring required

Represents the current Task Order Number. Subject to change over the lifetime of a Task Order. Should be considered metadata rather than a primary key (use the id instead).

pop_start_datestring date required

Start of period of performance for this Task Order in YYYY-MM-DD format.

pop_end_datestring date required

End of period of performance for this Task Order in YYYY-MM-DD format.

Example request

{
  "id": "csp-task-order-id-123",
  "task_order_number": "HQ003421F0024",
  "clins": [
    {
      "pop_start_date": "2021-07-22",
      "pop_end_date": "2026-07-21"
    }
  ],
  "pop_start_date": "2021-07-15",
  "pop_end_date": "2026-07-14"
}

Response

Successful operation

idstring required

Represents the unique ID of a Task Order. Must be defined by CSPs upon object creation.

task_order_numberstring required

Represents the current Task Order Number. Subject to change over the lifetime of a Task Order. Should be considered metadata rather than a primary key (use the id instead).

pop_start_datestring date required

Start of period of performance for this Task Order in YYYY-MM-DD format.

pop_end_datestring date required

End of period of performance for this Task Order in YYYY-MM-DD format.

Example response

{
  "id": "csp-task-order-id-123",
  "task_order_number": "HQ003421F0024",
  "clins": [
    {
      "pop_start_date": "2021-07-22",
      "pop_end_date": "2026-07-21"
    }
  ],
  "pop_start_date": "2021-07-15",
  "pop_end_date": "2026-07-14"
}

Changes

Changed in 15 of the 50 revisions of this API.181335

    • ○

      added the non-success response with the status

      response-non-success-status-added

  • 0290bea4247c21See the full diff
    • ●

      deleted the header request parameter X-Atat-Api-Version

      request-parameter-removed

    • ●

      deleted the path request parameter portfolioId

      request-parameter-removed

    • ○

      added the new optional header request parameter X-Atat-Api-Version to all path's operations

      new-optional-request-default-parameter-to-existing-path

  • 125039a132bc5510See the full diff
    • ▲

      removed the enum value cloud of the request property //

      request-property-enum-value-removed

    • ▲

      removed the enum value non_cloud of the request property //

      request-property-enum-value-removed

    • ▲

      removed the enum value secret of the request property //

      request-property-enum-value-removed

    • ▲

      removed the enum value top_secret of the request property //

      request-property-enum-value-removed

    • ▲

      removed the enum value unclassified of the request property //

      request-property-enum-value-removed

    • ●

      added the new CLOUD enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new NON_CLOUD enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new SECRET enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new TOP_SECRET enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new UNCLASSIFIED enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new CLOUD enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new NON_CLOUD enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new SECRET enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new TOP_SECRET enum value to the request property //

      request-property-enum-value-added

    • ○

      added the new UNCLASSIFIED enum value to the request property //

      request-property-enum-value-added

    • ○

      removed the cloud enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the non_cloud enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the secret enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the top_secret enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the unclassified enum value from the // response property for the response status

      response-property-enum-value-removed

  • 9fbf5defc05a113See the full diff
    • ▲

      added the new required request property //

      new-required-request-property

    • ●

      deleted the header request parameter X-Target-Impact-Level

      request-parameter-removed

    • ○

      added the new optional request property //

      new-optional-request-property

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ▲

      removed the success response with the status

      response-success-status-removed

    • ○

      added the success response with the status

      response-success-status-added

    • ▲

      removed the success response with the status

      response-success-status-removed

    • ○

      added the success response with the status

      response-success-status-added

    • ○

      added the new optional header request parameter X-Atat-Api-Version

      new-optional-request-parameter

    • ●

      deleted the header request parameter X-Atat-Api-Version

      request-parameter-removed