birth-events

Confirm a reviewed birth event

Save all reviewed animals, observations, relationships, care records, tasks and evidence in one transaction. Submit only request_id, bundle and confirmation_hash from the approved preview. Reusing the exact request is idempotent. A changed hash or reused request ID with different data returns 409; obtain approval of a fresh preview after corrections or changed farm evidence. External credential scopes: write:records, write:animals, write:groups. Minimum farm role: EDITOR.

post/v1/farm/{farm_id}/birth-events

Request

  • Base URL: https://api.ranch.bot
  • URL: https://api.ranch.bot/v1/farm/{farm_id}/birth-events
  • Auth: HTTP bearer

Path parameters

farm_idstring uuid required

Request body

request_idstring uuid required
confirmation_hashstring required

Response

Success

idstring uuid required
farm_idstring uuid required
request_idstring uuid required
confirmation_hashstring required
created_by_user_idstring uuid required
dam_idstring uuid required
birth_datestring date-time required
time_precisionstring nullable required
record_idstring uuid required
source_sms_idstring uuid nullable required
source_message_idstring uuid nullable required
agent_action_idstring uuid nullable required
created_atstring date-time required
media_file_idsstring[]

Unique, access-filtered file UUIDs referenced by the accepted birth evidence and the primary record.

Changes

No recorded changes to this operation across all 1 revision of this API.