# Documentation for Fleet API usage **URL:** \ **Category:** Beats\ **Tags:** fleet\ **Created:** [March 22, 2022, 10:01pm UTC](https://discuss.elastic.co/t/documentation-for-fleet-api-usage/300390 "2022-03-22T22:01:14Z")\ **Posts on this page:** 4\ **Page:** 1
**Author:** ![trudyc](https://avatars.discourse-cdn.com/v4/letter/t/f04885/32.png) [@trudyc](https://discuss.elastic.co/u/trudyc)\ **Post date:** [March 22, 2022, 10:01pm UTC](https://discuss.elastic.co/t/documentation-for-fleet-api-usage/300390/1 "2022-03-22T22:01:14Z")
Hello all, I am looking for better documentation about using the Fleet API in Elastic/Kibana 7.17. I have looked at [https://github.com/elastic/kibana/blob/7.17/x-pack/plugins/fleet/common/openapi/README.md](https://github.com/elastic/kibana/blob/7.17/x-pack/plugins/fleet/common/openapi/README.md) [https://petstore.swagger.io/?url=https://raw.githubusercontent.com/elastic/kibana/7.x/x-pack/plugins/fleet/common/openapi/bundled.json](https://petstore.swagger.io/?url=https://raw.githubusercontent.com/elastic/kibana/7.x/x-pack/plugins/fleet/common/openapi/bundled.json) I find these to be non-intuitive. For instance, I am trying to automate adding an "integration" (UI terminology) to a policy. None of the API endpoints listed indicates to me that it is the one to use. There are endpoints for "package" and "package\_policies", but not for "integration". I have resorted to using the Chrome browser Developer Tools to look at the network traffic when interacting with the UI to add an integration to a policy. That lead me to try the api/fleet/package\_policies endpoint. I took the payload reported through the browser developer tools and, in an environment where no changes had been made to the default policies, used that in my API call. I got back an error: ```auto FAILED! => {"cache_control": "private, no-cache, no-store, must-revalidate", "changed": false, "connection": "close", "content": "{\"statusCode\":404,\"error\":\"Not Found\",\"message\":\"Saved object [ingest-agent-policies/['']] not found\"}" ``` I don't see anything in the API docs about saved objects or ingest agent policies. Since integrations include saved objects I hypothesized that maybe I needed to install the integration first. So, I did that through the UI, and then retried the package\_policies endpoint again. I got the same response as above. I don't see many posts in this forum concerning Fleet API usage. Is it just not being used much at this point? Or am simply not finding the posts (due to flawed post searching criteria)? Is anybody working with the API to fully automate the set up of agent policies? ---
**Author:** ![Julia\_Bardi](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/julia_bardi/32/79463_2.png) [@Julia\_Bardi](https://discuss.elastic.co/u/Julia_Bardi)\ **Post date:** [March 23, 2022, 8:27am UTC](https://discuss.elastic.co/t/documentation-for-fleet-api-usage/300390/2 "2022-03-23T08:27:42Z")
Hi! You are using the right API , `package_policies` is for creating integration policies. I agree that the naming is not very intuitive. From the error message it seems like the agent policy is not found. Are you sure you are setting an existing agent policy id as the `policy_id` in the `package_policies` create request? As for the API docs, we have plans to add more documentation, and promote it officially to GA: [[Fleet] Promote Fleet API to GA · Issue #123150 · elastic/kibana · GitHub](https://github.com/elastic/kibana/issues/123150) ---
**Author:** ![trudyc](https://avatars.discourse-cdn.com/v4/letter/t/f04885/32.png) [@trudyc](https://discuss.elastic.co/u/trudyc)\ **Post date:** [March 23, 2022, 2:53pm UTC](https://discuss.elastic.co/t/documentation-for-fleet-api-usage/300390/3 "2022-03-23T14:53:46Z")
I figured out the cause of the error. Using Ansible, I was extracting the policy id from the system using a call to the agent\_policies API and then using json\_query to pull out the data. I'm fairly new to Ansible and did not realize that json\_query was returning a list with a single value rather than just the value alone. Fixing that resulted in a successful API call for package\_policies. ---
**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\ **Post date:** [April 20, 2022, 4:54pm UTC](https://discuss.elastic.co/t/documentation-for-fleet-api-usage/300390/4 "2022-04-20T16:54:28Z")
This topic was automatically closed 28 days after the last reply. New replies are no longer allowed.