> ## Documentation Index > Fetch the complete documentation index at: https://docs.effectiveai.app/llms.txt > Use this file to discover all available pages before exploring further. # Add a filing comment or reply > Requires MC and managed-filing edit permission. Omit target for the filing, or address one of its child records, a field, or an immutable artifact version attached to a filing/submission item. Vault access and version membership are checked when creating a document comment. Supply parentCommentId to reply to a top-level message and inherit its target. Authorship comes from the credential. Stored in existing filing annotations; no agent session is started. POST is not idempotent: inspect the timeline after an uncertain response before retrying. Imported filings are read-only. ## OpenAPI ````yaml /openapi.json post /managed-filings/{filingId}/comments openapi: 3.0.3 info: title: Effective API version: 2.0.0 description: The public Effective REST API. Authenticate using an Effective API key. servers: - url: https://effectiveai.app/api/v2 description: Production security: - bearerAuth: [] paths: /managed-filings/{filingId}/comments: post: tags: - Managed Filings summary: Add a filing comment or reply description: >- Requires MC and managed-filing edit permission. Omit target for the filing, or address one of its child records, a field, or an immutable artifact version attached to a filing/submission item. Vault access and version membership are checked when creating a document comment. Supply parentCommentId to reply to a top-level message and inherit its target. Authorship comes from the credential. Stored in existing filing annotations; no agent session is started. POST is not idempotent: inspect the timeline after an uncertain response before retrying. Imported filings are read-only. operationId: createManagedFilingComment parameters: - schema: type: string format: uuid required: true name: filingId in: path requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/V2ManagedFilingCommentCreate' responses: '201': description: Created comment. content: application/json: schema: $ref: '#/components/schemas/V2ManagedFilingComment' '400': description: Invalid fields or request. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '401': description: Authentication required. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '403': description: A write-capable user credential and edit access are required. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '404': description: >- Filing, item, reference, or registered record type is missing or inaccessible. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '409': description: >- Read-only filing, occupied schedule position, dependency, or concurrent change. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '415': description: Content-Type must be application/json. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '500': description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' '503': description: Dependency temporarily unavailable. content: application/json: schema: $ref: '#/components/schemas/V2CodedError' security: - bearerAuth: [] components: schemas: V2ManagedFilingCommentCreate: oneOf: - type: object properties: body: type: string minLength: 1 maxLength: 20000 pattern: \S target: allOf: - $ref: '#/components/schemas/V2ManagedFilingCommentTarget' - description: >- Omit for a filing-level comment. Target and revision cannot be changed after creation. required: - body additionalProperties: false - type: object properties: body: type: string minLength: 1 maxLength: 20000 pattern: \S parentCommentId: type: string format: uuid description: >- Reply to a top-level message in this filing. The reply inherits its thread target. Replies cannot have their own replies. required: - body - parentCommentId additionalProperties: false V2ManagedFilingComment: type: object properties: id: type: string threadId: type: string parentCommentId: type: string nullable: true commentType: type: string enum: - message - system - status_change actor: type: string body: type: string nullable: true data: type: object additionalProperties: nullable: true deleted: type: boolean editedAt: type: string nullable: true createdAt: type: string status: type: string enum: - open - resolved description: Resolution state of the whole annotation thread. anchor: $ref: '#/components/schemas/ResourceAnchor' target: $ref: '#/components/schemas/V2ManagedFilingCommentTarget' required: - id - threadId - parentCommentId - commentType - actor - body - data - deleted - editedAt - createdAt - status V2CodedError: allOf: - $ref: '#/components/schemas/V2Error' - type: object properties: code: type: string minLength: 1 description: Stable error code. Clients must tolerate unknown future codes. details: type: array items: type: object properties: location: type: string enum: - path - query - header - body path: type: array items: type: string maxLength: 64 maxItems: 12 code: type: string enum: - required - invalid_type - invalid_value - unknown_field message: type: string minLength: 1 maxLength: 200 required: - location - path - code - message minItems: 1 maxItems: 20 description: Bounded safe validation issues; may omit some invalid fields. requestId: type: string minLength: 1 maxLength: 128 description: >- Existing server correlation for this HTTP attempt, when available. required: - code V2ManagedFilingCommentTarget: oneOf: - type: object properties: type: type: string enum: - record recordType: type: string enum: - filings - filing_items - submissions - submission_items - objections - objection_items recordId: type: string format: uuid field: type: string pattern: ^[A-Za-z0-9_-]{1,128}$ required: - type - recordType - recordId additionalProperties: false - type: object properties: type: type: string enum: - artifact recordType: type: string enum: - filing_items - submission_items recordId: type: string format: uuid artifactId: type: string format: uuid artifactVersionId: type: string format: uuid description: >- Immutable Vault version UUID. Discover it through the existing artifact versions API. required: - type - recordType - recordId - artifactId - artifactVersionId additionalProperties: false description: >- Present on API-created discussions, inherited by replies. Older native discussions use anchor instead. ResourceAnchor: oneOf: - type: object properties: type: type: string enum: - whole_resource required: - type - type: object properties: type: type: string enum: - field path: type: string minLength: 1 required: - type - path description: Structural location within a resource V2Error: type: object properties: error: type: string minLength: 1 description: Human-readable explanation of the failure. required: - error securitySchemes: bearerAuth: type: http scheme: bearer description: 'Effective API key. Send Authorization: Bearer sk-eai-...' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.