generated: '2026-07-15' method: generated source: openapi/sendcloud-shipments-openapi.yml, openapi/sendcloud-v2-analytics-openapi.yml, openapi/sendcloud-v2-integrations-openapi.yml, openapi/sendcloud-v2-labels-openapi.yml, openapi/sendcloud-v2-parcel-documents-openapi.yml, openapi/sendcloud-v2-parcels-openapi.yml, openapi/sendcloud-v2-reporting-openapi.yml, openapi/sendcloud-v2-tracking-openapi.yml, openapi/sendcloud-v3-analytics-openapi.yml, openapi/sendcloud-v3-event-subscriptions-openapi.yml, openapi/sendcloud-v3-integrations-openapi.yml, openapi/sendcloud-v3-orders-openapi.yml, openapi/sendcloud-v3-parcel-documents-openapi.yml, openapi/sendcloud-v3-parcel-tracking-openapi.yml, openapi/sendcloud-v3-reporting-openapi.yml, openapi/sendcloud-v3-returns-openapi.yml, openapi/sendcloud-v3-service-points-openapi.yml, openapi/sendcloud-v3-ship-an-order-openapi.yml description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 94 by_action_class: acting: 42 connected: 52 by_consequence: physical: 20 read: 52 write: 22 human_in_the_loop_required: 0 operations: - path: /shipments/announce method: post operationId: sc-public-v3-scp-post-announce_shipment x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /shipments method: get operationId: sc-public-v3-scp-get-all_shipments x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /shipments method: post operationId: sc-public-v3-scp-post-create_shipment x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /shipments/announce-with-shipping-rules method: post operationId: sc-public-v3-scp-post-announce_shipment_with_rules x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /shipments/create-with-shipping-rules method: post operationId: sc-public-v3-scp-post-create_shipment_with_rules x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /addresses/validate method: post operationId: sc-public-v3-scp-post-validate_address x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /shipments/{id} method: get operationId: sc-public-v3-scp-get-shipment_by_id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /shipments/{id}/cancel method: post operationId: sc-public-v3-scp-post-cancel_shipment x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /shipments/{id}/return-portal-url method: get operationId: sc-public-v3-scp-get-return_portal_url x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /insights/parcels/series method: get operationId: sc-public-v2-analytics-get-parcels_series x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /insights/products/series method: get operationId: sc-public-v2-analytics-get-products_series x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /insights/parcels/buckets method: get operationId: sc-public-v2-analytics-get-parcels_buckets x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /insights/products/buckets method: get operationId: sc-public-v2-analytics-get-products_buckets x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /insights/parcels/counts-summary method: get operationId: sc-public-v2-analytics-get-parcels_summary x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /insights/carriers/transit-times method: get operationId: sc-public-v2-analytics-get-carrier_transit_times x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /insights/shipping-methods/transit-times method: get operationId: sc-public-v2-analytics-get-shipping_method_transit_times x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /analytics/shipping-methods method: get operationId: sc-public-v2-analytics-get-user_shipping_methods x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /analytics/carriers method: get operationId: sc-public-v2-analytics-get-user_carriers x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations method: get operationId: sc-public-v2-orders-get-retrieve_a_list_of_integrations x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations/{id} method: get operationId: sc-public-v2-orders-get-retrieve_an_integration x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations/{id} method: put operationId: sc-public-v2-orders-put-update_an_integration x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /integrations/{id} method: patch operationId: sc-public-v2-orders-patch-partial_update_an_integration x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /integrations/{id} method: delete operationId: sc-public-v2-orders-delete-delete_an_integration x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /integrations/{id}/shipments method: get operationId: sc-public-v2-orders-get-retrieve_a_list_of_shipments x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations/{id}/shipments method: post operationId: sc-public-v2-orders-post-create_a_list_of_shipments x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /integrations/{id}/shipments/delete method: post operationId: sc-public-v2-orders-post-delete_a_shipment x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /integrations/logs method: get operationId: sc-public-v2-orders-get-retrieve_integrations_logs x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations/{id}/logs method: get operationId: sc-public-v2-orders-get-retrieve_integration_logs x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations/{id}/logs method: post operationId: sc-public-v2-orders-post-create_integration_logs x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /labels/{parcel_id} method: get operationId: sc-public-v2-scp-get-label_by_parcel_id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /labels method: post operationId: sc-public-v2-scp-post-label_by_parcel_ids x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /labels/normal_printer/{parcel_id} method: get operationId: sc-public-v2-scp-get-label_document_normal_printer x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /labels/normal_printer method: get operationId: sc-public-v2-scp-get-label_document_multiple_normal_printer x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /customs_declaration/normal_printer/{parcel_id} method: get operationId: sc-public-v2-scp-get-customs_document_normal_printer x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /customs_declaration/normal_printer method: get operationId: sc-public-v2-scp-get-customs_document_multiple_normal_printer x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /labels/label_printer/{parcel_id} method: get operationId: sc-public-v2-scp-get-label_document_label_printer x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /labels/label_printer method: get operationId: sc-public-v2-scp-get-label_document_multiple_label_printer x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /parcels/{id}/documents/{type} method: get operationId: sc-public-v2-scp-get-retrieve_parcel_documents x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /parcels method: get operationId: sc-public-v2-scp-get-all_parcels x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /parcels method: post operationId: sc-public-v2-scp-post-create_parcel x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /parcels method: put operationId: sc-public-v2-scp-put-update_a_parcel x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /parcels/{id} method: get operationId: sc-public-v2-scp-get-parcel_by_id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /parcels/{id}/cancel method: post operationId: sc-public-v2-scp-post-cancel_specific x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /parcels/{id}/return_portal_url method: get operationId: sc-public-v2-scp-get-return_portal_url x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /reporting/parcels method: post operationId: sc-public-v2-reporting_analytics-post-parcels_report x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /reporting/parcels/{report_id} method: get operationId: sc-public-v2-reporting_analytics-get-parcels_report x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /tracking/{tracking_number} method: get operationId: sc-public-v2-tracking-get-detailed_tracking_information x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /analytics/transit-times/carriers method: get operationId: sc-public-v3-analytics-get-carrier_transit_times x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /analytics/transit-times/shipping-options method: get operationId: sc-public-v3-analytics-get-shipping_option_transit_times x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /event-subscriptions/connections method: post operationId: sc-public-v3-scp-post-create_connection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /event-subscriptions/connections method: get operationId: sc-public-v3-scp-get-list_connections x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /event-subscriptions/connections/{id} method: get operationId: sc-public-v3-scp-get-connection x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /event-subscriptions/connections/{id} method: patch operationId: sc-public-v3-scp-patch-connection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /event-subscriptions/connections/{id} method: delete operationId: sc-public-v3-scp-delete-connection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /event-subscriptions/connections/{id}/authorization method: post operationId: sc-public-v3-scp-post-start_authorization x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /event-subscriptions/subscriptions method: post operationId: sc-public-v3-scp-post-create_subscription x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /event-subscriptions/subscriptions method: get operationId: sc-public-v3-scp-get-list_subscriptions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /event-subscriptions/subscriptions/{id} method: get operationId: sc-public-v3-scp-get-subscription x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /event-subscriptions/subscriptions/{id} method: patch operationId: sc-public-v3-scp-patch-subscription x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /event-subscriptions/subscriptions/{id} method: delete operationId: sc-public-v3-scp-delete-subscription x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /event-subscriptions/broadcast/test/{subscription_id} method: post operationId: sc-public-v3-scp-post-test_broadcast x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /integrations/{id} method: delete operationId: sc-public-v3-integrations-delete-delete_integration x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /integrations/{id} method: patch operationId: sc-public-v3-integrations-patch-update_integration x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /integrations/{id} method: get operationId: sc-public-v3-integrations-get-retrieve_integration x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations method: get operationId: sc-public-v3-integrations-get-list_integrations x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations/logs method: get operationId: sc-public-v3-integrations-get-retrieve_integrations_logs x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations/{id}/logs method: get operationId: sc-public-v3-integrations-get-retrieve_integration_logs x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /integrations/{id}/logs method: post operationId: sc-public-v3-integrations-post-create_integration_logs x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /shop-order-statuses method: get operationId: sc-public-v3-integrations-get-shop_order_statuses x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /shop-order-statuses method: post operationId: sc-public-v3-integrations-post-shop_order_statuses x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /shop-order-statuses/mapping method: get operationId: sc-public-v3-integrations-get-shop_order_statuses_mapping x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /shop-order-statuses/mapping method: post operationId: sc-public-v3-integrations-post-shop_order_statuses_mapping x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /orders method: post operationId: sc-public-v3-orders-post-create_orders x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /orders method: get operationId: sc-public-v3-orders-get-list_orders x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /orders/{id} method: get operationId: sc-public-v3-orders-get-retrieve_order x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /orders/{id} method: delete operationId: sc-public-v3-orders-delete-delete_order x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /orders/{id} method: patch operationId: sc-public-v3-orders-patch-partial_update_order x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /parcels/{id}/documents/{type} method: get operationId: sc-public-v3-scp-get-retrieve_parcel_documents x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /parcel-documents/{type} method: get operationId: sc-public-v3-scp-get-retrieve_parcel_documents_bulk x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /parcels/tracking/{tracking_number} method: get operationId: sc-public-v3-shipping_intelligence_engine-get-get_parcel_by_tracking_number x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /parcels/tracking method: post operationId: sc-public-v3-shipping_intelligence_engine-post-register_parcel_for_tracking x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /reporting/parcels method: post operationId: sc-public-v3-reporting-post-create_parcels_report x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /reporting/parcels/{report_id} method: get operationId: sc-public-v3-reporting-get-retrieve_parcels_report x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /returns method: post operationId: sc-public-v3-scp-post-returns_create_new_return x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /returns method: get operationId: sc-public-v3-scp-get-returns_get_returns x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /returns/{id} method: get operationId: sc-public-v3-scp-get-returns_get_details x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /returns/{id}/cancel method: patch operationId: sc-public-v3-scp-patch-returns_cancel x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /returns/validate method: post operationId: sc-public-v3-scp-post-returns_validate x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /returns/announce-synchronously method: post operationId: sc-public-v3-scp-post-returns_create_new_return_synchronously x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /service-points method: get operationId: sc-public-v3-servicepoints-get-list_service_points x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /service-points/{service_point_id} method: get operationId: sc-public-v3-servicepoints-get-service_point x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /service-points/{service_point_id}/check-availability method: post operationId: sc-public-v3-servicepoints-post-check_availability x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /orders/create-labels-async method: post operationId: sc-public-v3-orders_labels-post-create_labels_async x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /orders/create-label-sync method: post operationId: sc-public-v3-orders_labels-post-create_labels_sync x-agentic-access: action-class: acting consequence: physical subject: required audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required