---
title: "Submit Action"
method: POST
path: "/api/v1/a2ui/surfaces/{surface_id}/actions"
tags: ["A 2 UI"]
---

# Submit Action

`POST /api/v1/a2ui/surfaces/{surface_id}/actions`

SubmitAction handles user actions on A2UI surfaces.

## Path parameters

- `surface_id` string, required — The surfaceId field.

## Request body

- C1ApiA2uiV1A2UIServiceSubmitActionRequestInput — A2UIServiceSubmitActionRequest submits a user action.
  - `actionName` string — The actionName field.
  - `clientTimestamp` string, date-time, nullable
  - `context` object — The context field.
  - `conversationId` string — The conversationId field.
  - `dataModelJson` string — The dataModelJson field.
  - `sourceComponentId` string — The sourceComponentId field.

## Response `200`

A2UIServiceSubmitActionResponse returns the result of an action.

- C1ApiA2uiV1A2UIServiceSubmitActionResponse — A2UIServiceSubmitActionResponse returns the result of an action.
  - `accepted` boolean — The accepted field.
  - `errorMessage` string — The errorMessage field.

## Changes

- **2026-08-21** `f2cf3228f366` — 1 info
  - the request property `clientTimestamp` became nullable
- **2026-03-10** `7fa698b04b81` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/a2ui/surfaces/:surface_id/actions/post.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)