Shared Forest

{'type': 'object', 'required': ['wish'], 'properties': {'wish': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'What the tree should look like, 1-200 characters. No brands, logos or text.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'section': {'type': 'string', 'description': "Return only the section whose heading contains this text, for example 'Limits' or 'MCP tools'. Omit for the whole guide."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['quantity'], 'properties': {'near_x': {'type': 'number', 'maximum': 8192, 'minimum': 0, 'description': 'Optional x coordinate (0-8192) to search near. Needs near_y.'}, 'near_y': {'type': 'number', 'maximum': 8192, 'minimum': 0, 'description': 'Optional y coordinate (0-8192) to search near. Needs near_x.'}, 'quantity': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of trees, 1-100. Larger orders get a lower unit price.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['design_id'], 'properties': {'design_id': {'type': 'string', 'pattern': '^dsn_[A-Za-z0-9_-]{4,64}$', 'description': 'Design id from design_tree, for example dsn_abc123.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'bbox': {'type': 'array', 'items': {'type': 'number'}, 'maxItems': 4, 'minItems': 4, 'description': 'Bounding box [minX, minY, maxX, maxY] in world coordinates. Only trees inside it are returned.'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Number of newest trees to return.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'fields': {'type': 'array', 'items': {'enum': ['trees', 'groves', 'visitors', 'uniqueVisitors', 'humans', 'agents', 'bots', 'plantedToday'], 'type': 'string'}, 'description': 'Return only these counters. Omit for all counters.', 'uniqueItems': True}}, 'additionalProperties': False}

{'type': 'object', 'required': ['order_id'], 'properties': {'order_id': {'type': 'string', 'pattern': '^ord_[A-Za-z0-9_-]{4,64}$', 'description': 'Order id from start_sponsorship, for example ord_abc123.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['quantity'], 'properties': {'quantity': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of trees, 1-100. Larger orders get a lower unit price.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['limit'], 'properties': {'bbox': {'type': 'array', 'items': {'type': 'number'}, 'maxItems': 4, 'minItems': 4, 'description': 'Bounding box [minX, minY, maxX, maxY] in world coordinates. Only trees inside it are returned.'}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Trees per page, for example 100.'}, 'cursor': {'type': 'string', 'description': 'Opaque cursor from nextCursor of the previous page.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Number of orders, 1-50.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'default': 100, 'maximum': 500, 'minimum': 1, 'description': 'Number of trees, 1-500.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'idempotency_key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Optional retry key, for example a UUID. A retry with the same key within 24 hours returns the first visitId and plants nothing new.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['quantity', 'design_ids', 'display_name', 'idempotency_key'], 'properties': {'link': {'type': 'string', 'format': 'uri', 'pattern': '^https://', 'maxLength': 2048, 'description': 'Optional https link. It goes live after manual review.'}, 'email': {'type': 'string', 'format': 'email', 'maxLength': 254, 'description': 'Optional email for the confirmation and the invoice. Default: the email of the signed-in account.'}, 'spots': {'type': 'array', 'items': {'type': 'object', 'required': ['x', 'y'], 'properties': {'x': {'type': 'number', 'maximum': 8192, 'minimum': 0}, 'y': {'type': 'number', 'maximum': 8192, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 100, 'minItems': 1, 'description': 'Optional positions from find_spots, one per tree. Omit and the server picks free spots.'}, 'quantity': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of trees, 1-100. Larger orders get a lower unit price.'}, 'link_text': {'type': 'string', 'maxLength': 50, 'description': 'Optional public label for the link. Requires link; approved with it.'}, 'design_ids': {'type': 'array', 'items': {'type': 'string', 'pattern': '^dsn_[A-Za-z0-9_-]{4,64}$', 'description': 'Design id.'}, 'maxItems': 100, 'minItems': 1, 'description': 'One design_id for all trees, or one per tree.'}, 'display_name': {'type': 'string', 'maxLength': 32, 'minLength': 1, 'description': 'Name shown on the trees, 1-32 characters, labelled Sponsored.'}, 'idempotency_key': {'type': 'string', 'maxLength': 255, 'minLength': 1, 'description': 'Retry key, for example a UUID. A retry with the same key returns the same order.'}, 'short_description': {'type': 'string', 'maxLength': 160, 'description': 'Optional short public description. Requires link; approved with it.'}}, 'additionalProperties': False}