{"_id":"5845a4a89f6fbb1b004307c5","category":{"_id":"5845a4a89f6fbb1b004307ba","__v":0,"version":"5845a4a89f6fbb1b004307b7","project":"54d3007669578e0d002730c9","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-30T06:53:33.020Z","from_sync":false,"order":2,"slug":"api-reference","title":"API reference"},"parentDoc":null,"__v":3,"user":"54d3006a5616470d0013cc4d","version":{"_id":"5845a4a89f6fbb1b004307b7","project":"54d3007669578e0d002730c9","__v":2,"createdAt":"2016-12-05T17:32:24.708Z","releaseDate":"2016-12-05T17:32:24.708Z","categories":["5845a4a89f6fbb1b004307b8","5845a4a89f6fbb1b004307b9","5845a4a89f6fbb1b004307ba","5845a4a89f6fbb1b004307bb","5845a4a89f6fbb1b004307bc","5845a4a89f6fbb1b004307bd","5845a4a89f6fbb1b004307be","5845a4a89f6fbb1b004307bf","5845a4a89f6fbb1b004307c0","592deb23644f060f008e5aa6"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"25.0.0","version":"25"},"project":"54d3007669578e0d002730c9","updates":["566cae1b7831040d003eb3ca","56c1d19b075f5d0d00d67dfd","56c73488f795cf0d003ec170","584f70a1701535230053f766","58bcc059352e950f00529d01","59335caee0cce7000fce16c7"],"next":{"pages":[],"description":""},"createdAt":"2015-09-02T19:47:50.636Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"API.AI REST-like HTTP endpoints allow you to submit queries and manage and modify the various parts of your agent (intents, entities, etc.).\n\n\n\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Base URL\"\n}\n[/block]\nAll the URLs referenced in the documentation have the following base:\n``` https://api.api.ai/v1/ ```\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"General Information\"\n}\n[/block]\n* <a href=\"https://docs.api.ai/docs/authentication\" target=\"_blank\">Authentication</a> – read about how to authenticate in the API and use access keys\n* <a href=\"https://docs.api.ai/docs/versioning\" target=\"_blank\">Versioning</a>\n* <a href=\"https://docs.api.ai/docs/languages\" target=\"_blank\">Languages</a> \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Resources\"\n}\n[/block]\n* <a href=\"https://docs.api.ai/docs/query\" target=\"_blank\">/query</a>  – submit text queries\n* <a href=\"https://docs.api.ai/docs/entities\" target=\"_blank\">/entities</a> – manage entities\n* <a href=\"https://docs.api.ai/docs/userentities\" target=\"_blank\">/userEntities</a> – manage user-level entities\n* <a href=\"https://docs.api.ai/docs/intents\" target=\"_blank\">/intents</a> – manage intents\n* <a href=\"https://docs.api.ai/docs/contexts\" target=\"_blank\">/contexts</a> –  manage contexts\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Miscellaneous\"\n}\n[/block]\n* <a href=\"https://docs.api.ai/docs/status-object\" target=\"_blank\">Status Object</a>\n* <a href=\"https://docs.api.ai/docs/status-and-error-codes\" target=\"_blank\">Status and Error Codes</a>","excerpt":"Introduction into HTTP API","slug":"reference","type":"basic","title":"Introduction"}

Introduction

Introduction into HTTP API

API.AI REST-like HTTP endpoints allow you to submit queries and manage and modify the various parts of your agent (intents, entities, etc.). [block:api-header] { "type": "basic", "title": "Base URL" } [/block] All the URLs referenced in the documentation have the following base: ``` https://api.api.ai/v1/ ``` [block:api-header] { "type": "basic", "title": "General Information" } [/block] * <a href="https://docs.api.ai/docs/authentication" target="_blank">Authentication</a> – read about how to authenticate in the API and use access keys * <a href="https://docs.api.ai/docs/versioning" target="_blank">Versioning</a> * <a href="https://docs.api.ai/docs/languages" target="_blank">Languages</a> [block:api-header] { "type": "basic", "title": "Resources" } [/block] * <a href="https://docs.api.ai/docs/query" target="_blank">/query</a> – submit text queries * <a href="https://docs.api.ai/docs/entities" target="_blank">/entities</a> – manage entities * <a href="https://docs.api.ai/docs/userentities" target="_blank">/userEntities</a> – manage user-level entities * <a href="https://docs.api.ai/docs/intents" target="_blank">/intents</a> – manage intents * <a href="https://docs.api.ai/docs/contexts" target="_blank">/contexts</a> – manage contexts [block:api-header] { "type": "basic", "title": "Miscellaneous" } [/block] * <a href="https://docs.api.ai/docs/status-object" target="_blank">Status Object</a> * <a href="https://docs.api.ai/docs/status-and-error-codes" target="_blank">Status and Error Codes</a>