records

Create Record

Current records HTTP operation. External credential scopes: write:records; a typed traceability payload that carries identification.profile_update additionally requires write:animals. Minimum farm role: EDITOR. Direct requests execute without an app confirmation screen. Production rate limit: 100 requests per 15-minute window per device account, 1000 per browser session, otherwise per client IP. RateLimit headers report the current window; respect Retry-After on 429. Legacy creation requires at least one animal_ids or group_ids entry attached to an active entity in this farm. Typed creation supplies traceability and requires an opaque request_key (1-200 characters); it does not require those associations. The 201 response is the created record for legacy creation or a { "event": ... } envelope for typed creation. Associations must name active entities in this farm; the service filters out ids outside that set. Supply ids obtained from the same farm.

post/v1/farm/{farm_id}/records

Request

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

Path parameters

farm_idstring uuid required

Request body

OR
OR

Response

Success

OR

Changes

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