cancel
Showing results for 
Search instead for 
Did you mean: 

I'm having issues understanding the Task Management section of the Service Titan API . I have an API key, and I'm able to do the GET /v1/taskmanagement/data request, but this just returns the data structure and not actual tasks. Want to POST, too.

Previous ContributorPrevious Contributor
Former Community Member

I'm having issues understanding the Task Management section of the Service Titan API . I have an API key, and I'm able to do the GET /v1/taskmanagement/data request, but this just returns the data structure and not actual tasks. Want to POST, too.

8 REPLIES 8

Previous ContributorPrevious Contributor
Former Community Member

No worries at all! Having access to the v2 API documentation is awesome. I'll let you know on this post, for sure.

wch_alex
ServiceTitan Certified Administrator
ServiceTitan Certified Administrator

Yeah sorry about not resolving the post. I tried my best to guide you in the right direction. Also integrations@servicetitan.com is very slow at responding... Again sorry, do let us know if you figure something out... It is probably something very simple, try and get someone else to look at your api access.

Previous ContributorPrevious Contributor
Former Community Member

Gotcha, I appreciate the help 🙂 I've reached out integrations@servicetitan.com, but they've been pretty slow to respond - I think it's been 2 weeks? If I get it squared away, I'll post the solution here. Thanks again!

wch_alex
ServiceTitan Certified Administrator
ServiceTitan Certified Administrator

Hmmm, I see. I am not too sure on that issue then. I can only really guide you at this point. You could try contacting Service Titan Support?

Previous ContributorPrevious Contributor
Former Community Member

Thanks again for the quick reply! I did notice a little while ago that the Redoc site was for the v2 API - this is very valuable to see, as we use the v1 API for key tasks at my company, and need to know what's in the pipeline. I tried using the v2 API calls using the following request: https://api.servicetitan.io/v2/taskmanagement/data?serviceTitanApiKey={our API Key}

but I noticed that this API isn't up and running yet.

The GET request works and returns the data structure, but not actual tasks in our Service Titan instance. Using the v1 API call at docs.servicetitan.com, I still get the 500 error when trying to do the POST request. Not sure if I'm missing something like header info or parameters...

Here's the API string I used for the POST request in Postman: https://api.servicetitan.com/v1/taskmanagement/tasks?id=20655&serviceTitanApiKey={our API key}

The id=20655 is a legitimate task ID from our Service Titan instance. I also get the same error when I don't specify an id in the request. Any ideas?

I just want to pull all existing tasks from Service Titan and then POST select ones back with updates.

wch_alex
ServiceTitan Certified Administrator
ServiceTitan Certified Administrator

Hi,

Lets try this again, I just finished what I had typed out and the page refreshed...

Anyways, yes the 404 error I see is a problem on that redoc site, its main use is to know a little bit of the syntax. Here is another link that I think could be helpful,

https://docs.servicetitan.com/

I believe I accidentally gave you the v2 docs which will be released this Fall..... Please review the /v1 docs because that is what is currently being used. Sorry for the errors and the confusion.

Let me know if this works for you!

Previous ContributorPrevious Contributor
Former Community Member

Thanks so much! I love the ReDoc page link you sent over.

The GET and POST requests don't seem to work on the ReDoc page, but I may just not be using it correctly. I get a 404 error when running either, for some reason.

Have you found a way to make a call to pull all Tasks, rather than just the data structure?

The end goal is for me to be able to pull the JSON data of all Tasks (with necessary filters), and plug this data into an external tool to manage email workflow for tasks and POST updates to these tasks back to Service Titan. I'm not sure how to pull the actual tasks from Service Titan, though, as the GET request seems to only return a skeleton data structure and not the actual tasks.

Does that make sense?

Also, for what it's worth, when I make the following POST request in Postman, using a legitimate task ID, I get a 500 server error.

https://api.servicetitan.com/v1/taskmanagement/tasks?id=20655&serviceTitanApiKey={our API key assigned by Service Titan}

Thanks again for your help!

wch_alex
ServiceTitan Certified Administrator
ServiceTitan Certified Administrator

Hi,

So I looked into this a little and it appears as a data structure. This is how you access the data.

Here is the link I used: https://servicetitan-v2-draft.redoc.ly/tag/Task-Management

I highly recommend using it, it is a great resource! Let me know if there are any other issues, it is possible otherwise the API is down. Our site was down earlier today.